react-emoj

0.1.2 • Public • Published

react-emoj Build Status Coverage Status

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 to ReactEmoji (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

/react-emoj/

    Package Sidebar

    Install

    npm i react-emoj

    Weekly Downloads

    4

    Version

    0.1.2

    License

    MIT

    Last publish

    Collaborators

    • yatharth