1.0.5 • Published 10 months ago
@raasz/customisable-react-native-emoji-selector v1.0.5
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-selectorimport EmojiSelector from '@manu_omg/customisable-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!
