Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/emish89/smile2emoji
Plugin to convert from text smile to emoticons. Emoji from punctuation
https://github.com/emish89/smile2emoji
emoji javascript smile smile-detection typescript
Last synced: about 24 hours ago
JSON representation
Plugin to convert from text smile to emoticons. Emoji from punctuation
- Host: GitHub
- URL: https://github.com/emish89/smile2emoji
- Owner: emish89
- License: mit
- Created: 2019-06-13T15:49:36.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-07T10:15:08.000Z (2 days ago)
- Last Synced: 2025-01-07T11:29:51.075Z (2 days ago)
- Topics: emoji, javascript, smile, smile-detection, typescript
- Language: TypeScript
- Homepage: https://codepen.io/emish89/pen/YzGrvVK
- Size: 3.41 MB
- Stars: 24
- Watchers: 2
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Smile2Emoji NPM Module
[](https://badge.fury.io/js/smile2emoji)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Femish89%2Fsmile2emoji?ref=badge_shield)
[](https://opensource.org/licenses/MIT)
[](https://codeclimate.com/github/emish89/smile2emoji/maintainability)
**Convert all the smiley to fantastic emoticons!** ✨
With this simple and little module you can convert the smiles in your text to emoji.
:) or :D or <3 will become emoticons!
Ideal for input, chats and so on, where you don't want an emoji picker but a simpler solution.
Very quick test usage:
https://codepen.io/emish89/pen/YzGrvVK
Happy usage =)
# Installation
```shell
npm i smile2emoji
```
# Usage
Objects exported by the package:
## FUNCTIONS EXPORTED
**checkText(text: string): string**
Function to check if in the string parameter there is some emoji and in case convert it.
Example:
```js
import { checkText } from 'smile2emoji'
...
const text = checkText(':)');
console.log(text) //prints '😊'
//OR
const text = checkText('i like bananas :)');
console.log(text) //prints 'i like bananas 😊'
```
**checkTextWithAutoSuggestions(text: string): string**
Same as before but with autosuggestion, so if there is only one emoji key in the map starting with the string, it use it.
```js
import { checkTextWithAutoSuggestions } from 'smile2emoji'
...
const text = checkTextWithAutoSuggestions(':tenn');
console.log(text) //prints '🎾'
//OR
const text = checkTextWithAutoSuggestions('i like bananas :tenn');
console.log(text) //prints 'i like bananas 🎾'
```
**checkTextWithAutoSuggestionsAndUnicode(text: string): string**
Same function but it use the map with unicode char instead of emoji, same results:
```js
import { checkTextWithAutoSuggestionsAndUnicode } from 'smile2emoji'
...
const text = checkTextWithAutoSuggestionsAndUnicode(':tenn');
console.log(text) //prints '🎾'
//OR
const text = checkTextWithAutoSuggestionsAndUnicode('i like bananas :tenn');
console.log(text) //prints 'i like bananas 🎾'
```
**fromUnicodeToEmoji(text: string): string**
Used by the function above, it convert an unicode string to emoji.
Example usage:
```js
import { fromUnicodeToEmoji } from 'smile2emoji'
const text = fromUnicodeToEmoji('2615');
console.log(text) //prints '☕'
```
## **MAPS EXPORTED**:
**emojiMap: { [key: string]: string }**
In this map is exported a pair of key-value string -emoji , like ':)' -> 😊
**mapStringToUnicode: { [key: string]: string }**
In this map is exported a pair of key-value string -unicode of the emoji , like ': coffee:' -> '2615'
Example usage:
```js
import { emojiMap } from 'smile2emoji'
...
const text = ':)';
const emoji = emojiMap[text];
console.log(emoji) //prints '😊'
```
# License
MIT © Federico Ballarini
[](https://app.fossa.io/projects/git%2Bgithub.com%2Femish89%2Fsmile2emoji?ref=badge_large)