react-emoj
v0.1.2
Published
Easy-use emoji component for React
Downloads
8
Maintainers
Readme
react-emoj
Easy-use emoji component for React
Installation
npm install --save react-emoj
Usage
react-emoj
serves a minimal and convenient API for use.
Module exports
ReactEmoji
as React Component (default export)Emoji
as an emoji utility that serves internally as a helper toReactEmoji
(exports.Emoji)
You can import them as:
import ReactEmoji, { Emoji } from 'react-emoj'
API
ReactEmoji
ReactEmoji shall be rendered with props
:
emoji
Type: Array(string)
Example:
<ReactEmoji emoji={['coffee', 'sunglasses']} />
Useful when all you need to render is a list of emoticons.
style
Type: Object
Example:
<ReactEmoji
emoji={['coffee', 'sunglasses']}
style={{fontSize: '30px'}}
/>
Useful when you need to set color/font size of text or emoticons.
ReactEmoji can be used for displaying text that includes emoji by passing the text as child to the component. The text must always be of type string
. The emoticons to be displayed shall be wrapped in colons in format :emoji_code:
.
Example:
<ReactEmoji style={{fontSize: '30px'}}>
I :hearts: coffee
</ReactEmoji>
Emoji
.emoji
Serves you a JSON
object of emoji.
.emojify(text)
Type: text: string
Emoji Format: :emoji_code:
Example:
Emoji.emojify('I love :coffee:') // I love ☕️
Useful when all you need is an emojified
text, not a rendered component.
.fromArray(emojiList)
Type: emojiList: [string] i.e an Array of string
Emoji Format: emoji_code
Example:
Emoji.fromArray(['coffee', 'sunglasses']) // ☕️😎
Useful when all you need is an emoji list, not a rendered component.
License
MIT © Yatharth Khatri