☕️ Android Aroma EmojiPicker
The Android Aroma EmojiPicker package provides an emojipicker with automatic day and night mode. This README describes how to implement the EmojiPicker into an app.
This GitHub repository is a mirror, the official repository is hosted privately by Coffee IT.
Created by Coffee IT. Look at our other repositories on our GitHub account.
⚡ Installation
This component requires minimum SDK 21.
Add the following to build.gradle:
dependencies {
implementation "nl.coffeeit.aroma:emojipicker:1.0.4"
}
? Usage
To use the EmojiPicker in a project, simply add it to your code like this:
val emojiBottomSheetDialogFragment = EmojiBottomSheet.newInstance({ emoji ->
// Handle emoji click
})
emojiBottomSheetDialogFragment.show(supportFragmentManager, EmojiBottomSheet.TAG)
Make sure to add the following in the AndroidManifest.xml as an activity tag attribute of the
Activity you’re using the EmojiPicker in android:configChanges="screenLayout|orientation|screenSize".
This makes sure the EmojiPicker keeps working when the configuration changes when it’s opened.
EmojiPicker also contains an extension method to convert unicode back into an emoji. Example:
The unicode for the Welsh flag emoji (???????????????????) is 0x1F3F40xE00670xE00620xE00770xE006C0xE00730xE007F and when using the toEmoji
method on that String, it’s converted to ??????????????????? again. It can be used as follows:
"0x1F3F40xE00670xE00620xE00770xE006C0xE00730xE007F".toEmoji() or emoji.unicode.toEmoji().
⚙️ Customisation
EmojiPicker uses the following color resources, which can be overwritten:
<color name="emojiPickerBackground"></color>
<color name="emojiPickerBackgroundInput"></color>
<color name="emojiPickerCategoryIconTint"></color>
<color name="emojiPickerDivider"></color>
<color name="emojiPickerSearchIconTint"></color>
<color name="emojiPickerSelectedCategoryIconTint"></color>
<color name="emojiPickerText"></color>
? Multi-language
The EmojiPicker supports 39 languages: Arabic, Catalan, Czech, Danish, German, Greek, English, Australian English, British English, Spanish, Latin, Finnish, French, Canadian, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Norwegian, Dutch, Polish, Brazilian Portuguese, Portuguese, Romanian, Russian, Slovak, Swedish, Thai, Turkish, Ukrainian, Vietnamese, Simplified Chinese, Traditional Chinese and Hong Kong Chinese. Searching for an emoji can only be done in the English language.
✏️ Changelog
Version 1.0.4 (22-08-2022)
- Changed color names to the following so they are more easily overwritable:
<color name="emojiPickerBackground"></color>
<color name="emojiPickerBackgroundInput"></color>
<color name="emojiPickerCategoryIconTint"></color>
<color name="emojiPickerDivider"></color>
<color name="emojiPickerSearchIconTint"></color>
<color name="emojiPickerSelectedCategoryIconTint"></color>
<color name="emojiPickerText"></color>
Version 1.0.3 (04-08-2022)
- Improved support for mutliple unicodes.
- Added extension method
toEmoji()to convert unicode to an emoji.
Version 1.0.2 (03-08-2022)
- Made unicode field support mutliple unicodes.
Version 1.0.1 (14-07-2022)
- Removed automatic refresh of recents. Recents update when the EmojiPicker is opened.
Version 1.0.0 (08-07-2022)
- Added EmojiPicker.
? Contact
Do you have questions, ideas or need help? Send us an email at [email protected].
⚠️ License
Android Aroma EmojiPicker is licensed under the terms of the MIT Open Source license.
