1.0.3 • Published 2 years ago
@manu_omg/react-native-emoji-selector v1.0.3
react-native-emoji-selector
A fully customizable Emoji-Selector 🤩 for React Native ⚛️ forked from react-native-emoji-selector to resolved some issues (recently used emojis, styling, ...) and allow more customization 👋
Installation
npm install --save @manu_omg/react-native-emoji-selector
import EmojiSelector from '@manu_omg/react-native-emoji-selector'
Demo
Usage
Basic usage
<EmojiSelector onEmojiSelected={emoji => console.log(emoji)}/>
Setting a default category
If you'd like to define a different default category, you can import the Categories
class. Setting a default category
can also improve performance by loading a single section rather than all sections at once.
import EmojiSelector, {Categories} from "react-native-emoji-selector";
<EmojiSelector
category={Categories.symbols}
onEmojiSelected={emoji => console.log(emoji)}
/>;
The available categories are all
, emotion
, people
, nature
, food
, activities
, places
, objects
, symbols
,
and flags
.
Props
Prop | Type | Default | Description |
---|---|---|---|
onEmojiSelected | func | Function called when a user selects an Emoji | |
theme | string | "007AFF" | Theme color used for loaders and active tab indicator |
showTabs | bool | true | Toggle the tabs on or off |
showSearchBar | bool | true | Toggle the searchbar on or off |
showHistory | bool | false | Toggle the history tab on or off |
showSectionTitles | bool | true | Toggle the section title elements |
category | enum | emotion | Set the default category. Use the Categories class |
columns | number | 6 | Number of columns accross |
placeholder | string | "Search..." | A string placeholder when there is no text in text input |
shouldInclude | func | Function called to check for emoji inclusion | |
searchbarStyle | StyleProp\ | Styles for SearchBar | |
searchbarContainerStyle | StyleProp\ | Styles for SearchBar Container | |
placeholderTextColor | string | Text color for SearchBar placeholder | |
categoryButtonStyle | StyleProp\ | Styles for each Emoji-Category Button | |
categoryTextStyle | StyleProp\ | Styles for Emoji-Category Text |
Contributors
Special thanks to everyone who has contributed to this project!