react-native-emoji-selector
A fully customizable Emoji-Selector
Installation
npm install --save @manu_omg/react-native-emoji-selector
import 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<TextStyle> | Styles for SearchBar | |
searchbarContainerStyle | StyleProp<ViewStyle> | Styles for SearchBar Container | |
placeholderTextColor | string | Text color for SearchBar placeholder | |
categoryButtonStyle | StyleProp<ViewStyle> | Styles for each Emoji-Category Button | |
categoryTextStyle | StyleProp<TextStyle> | Styles for Emoji-Category Text |
Contributors
Special thanks to everyone who has contributed to this project!