Popularity
7.6
Growing
Activity
8.3
-
1,495
40
286

Code Quality Rank: L5
Programming language: Kotlin
License: Apache License 2.0
Tags: Other Widget    
Latest version: v0.12.0

Emoji alternatives and similar packages

Based on the "Other Widget" category.
Alternatively, view Emoji alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Emoji or a related project?

Add another 'Other Widget' Package

README

Emoji

A library to add Emoji support to your Android app. Emojis can be picked in a PopupWindow. In order to edit and display text with Emojis this library provides public APIs:

  • [EmojiAutoCompleteTextView](emoji/src/main/java/com/vanniktech/emoji/EmojiAutoCompleteTextView.kt)
  • [EmojiButton](emoji/src/main/java/com/vanniktech/emoji/EmojiButton.kt)
  • [EmojiCheckbox](emoji/src/main/java/com/vanniktech/emoji/EmojiCheckbox.kt)
  • [EmojiEditText](emoji/src/main/java/com/vanniktech/emoji/EmojiEditText.kt)
  • [EmojiMultiAutoCompleteTextView](emoji/src/main/java/com/vanniktech/emoji/EmojiMultiAutoCompleteTextView.kt)
  • [EmojiTextView](emoji/src/main/java/com/vanniktech/emoji/EmojiTextView.kt)

There's also a [EmojiLayoutFactory](emoji/src/main/java/com/vanniktech/emoji/EmojiLayoutFactory.kt), which can be used to get automatic Emoji support when using normal Android Views such as TextView, Checkbox, etc.

Material Design Library bindings can be included via:

implementation "com.vanniktech:emoji-material:0.12.0"
  • [EmojiMaterialButton](emoji-material/src/main/java/com/vanniktech/emoji/material/EmojiMaterialButton.kt)
  • [EmojiMaterialRadioButton](emoji-material/src/main/java/com/vanniktech/emoji/material/EmojiMaterialRadioButton.kt)
  • [MaterialCheckBox](emoji-material/src/main/java/com/vanniktech/emoji/material/MaterialCheckBox.kt)
  • [EmojiTextInputEditText](./emoji-material/src/main/java/com/vanniktech/emoji/material/EmojiTextInputEditText.kt)

There's also a [MaterialEmojiLayoutFactory](emoji-material/src/main/java/com/vanniktech/emoji/material/MaterialEmojiLayoutFactory.kt), which can be used to get automatic Emoji support.

The library has 4 different providers to choose from (iOS, Google, Facebook & Twitter).

iOS Emojis

For getting the above iOS Emojis simply add the dependency and code below.

implementation "com.vanniktech:emoji-ios:0.12.0"

And install the provider in your application class.

EmojiManager.install(IosEmojiProvider());

Google

For getting the above Google Emojis simply add the dependency and code below.

implementation "com.vanniktech:emoji-google:0.12.0"

And install the provider in your application class.

EmojiManager.install(GoogleEmojiProvider());

Facebook

For getting the above Facebook Emojis simply add the dependency and code below.

implementation "com.vanniktech:emoji-facebook:0.12.0"

And install the provider in your application class.

EmojiManager.install(FacebookEmojiProvider());

Twitter

For getting the above Twitter Emojis simply add the dependency and code below.

implementation "com.vanniktech:emoji-twitter:0.12.0"

And install the provider in your application class.

EmojiManager.install(TwitterEmojiProvider());

Custom Emojis

If you want to display your own Emojis you can create your own implementation of [EmojiProvider](emoji/src/main/java/com/vanniktech/emoji/EmojiProvider.kt) and pass it to EmojiManager.install.

All of the core API lays in emoji, which is being pulled in automatically by the provided implementations:

implementation "com.vanniktech:emoji:0.12.0"

Set up

Inserting Emojis

Declare your [EmojiEditText](emoji/src/main/java/com/vanniktech/emoji/EmojiEditText.kt) in your layout xml file.

<com.vanniktech.emoji.EmojiEditText
  android:id="@+id/emojiEditText"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:imeOptions="actionSend"
  android:inputType="textCapSentences|textMultiLine"
  android:maxLines="3"/>

To open the [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt) execute the code below:

final EmojiPopup emojiPopup = EmojiPopup(rootView, emojiEditText);
emojiPopup.toggle(); // Toggles visibility of the Popup.
emojiPopup.dismiss(); // Dismisses the Popup.
emojiPopup.isShowing(); // Returns true when Popup is showing.

The rootView is the rootView of your layout xml file which will be used for calculating the height of the keyboard. emojiEditText is the [EmojiEditText](emoji/src/main/java/com/vanniktech/emoji/EmojiEditText.kt) that you declared in your layout xml file.

Displaying Emojis

<com.vanniktech.emoji.EmojiTextView
  android:id="@+id/emojiTextView"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"/>

Just use the [EmojiTextView](emoji/src/main/java/com/vanniktech/emoji/EmojiTextView.kt) and call setText with the String that contains Unicode encoded Emojis. To change the size of the displayed Emojis use the lineHeight property from TextView.

EmojiPopup Listeners

The [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt) class allows you to declare several listeners.

EmojiPopup(
  onSoftKeyboardCloseListener = { },
  onEmojiClickListener = { },
  onSoftKeyboardOpenListener = { },
  onEmojiPopupShownListener = { },
  onEmojiPopupDismissListener = { },
  onEmojiBackspaceClickListener = { },
)

EmojiPopup Configuration

Custom Recent Emoji implementation

You can pass your own implementation of the recent Emojis. Implement the [RecentEmoji](emoji/src/main/java/com/vanniktech/emoji/RecentEmoji.kt) interface and pass it when you're building the [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt):

EmojiPopup(
  recentEmoji = yourClassThatImplementsRecentEmoji,
)

If no instance or a null instance is set the [default implementation](emoji/src/main/java/com/vanniktech/emoji/RecentEmojiManager.kt) will be used.

Custom Variant Emoji implementation

You can pass your own implementation of the variant Emojis. Implement the [VariantEmoji](emoji/src/main/java/com/vanniktech/emoji/VariantEmoji.kt) interface and pass it when you're building the [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt):

EmojiPopup(
  variantEmoji = yourClassThatImplementsVariantEmoji,
)

If no instance or a null instance is set the [default implementation](emoji/src/main/java/com/vanniktech/emoji/VariantEmojiManager.kt) will be used.

Custom Search Emoji implementation

You can pass your own implementation for searching Emojis. Implement the [SearchEmoji](emoji/src/main/java/com/vanniktech/emoji/SearchEmoji.kt) interface and pass it when you're building the [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt):

EmojiPopup(
  searchEmoji = yourClassThatImplementsSearchEmoji,
)

If no instance or a null instance is set the [default implementation](emoji/src/main/java/com/vanniktech/emoji/SearchEmojiManager.kt) will be used.

Animations

Custom keyboard enter and exit animations

You can pass your own animation style for enter and exit transitions of the Emoji keyboard while you're building the [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt):

EmojiPopup(
  keyboardAnimationStyle = emoji_fade_animation_style,
)

If no style is set the keyboard will appear and exit as a regular PopupWindow. This library currently ships with two animation styles as an example:

  • R.style.emoji_slide_animation_style
  • R.style.emoji_fade_animation_style

Custom page transformers

You can pass your own Page Transformer for the Emoji keyboard View Pager while you're building the [EmojiPopup](emoji/src/main/java/com/vanniktech/emoji/EmojiPopup.kt):

EmojiPopup(
  pageTransformer = MagicTransformer(),
)

If no transformer is set ViewPager will behave as its usual self. Please do note that this library currently does not ship any example Page Transformers.

Other goodies

  • [MaximalNumberOfEmojisInputFilter](./emoji/src/main/kotlin/com/vanniktech/emoji/inputfilters/MaximalNumberOfEmojisInputFilter.kt) can be used to limit the number of Emojis one can type into an EditText
  • [OnlyEmojisInputFilter](./emoji/src/main/kotlin/com/vanniktech/emoji/inputfilters/OnlyEmojisInputFilter.kt) can be used to limit the input of an EditText to emoji only
  • [ForceSingleEmojiTrait](./emoji/src/main/kotlin/com/vanniktech/emoji/traits/ForceSingleEmojiTrait.kt) can be used to force a single emoji which can be replaced by a new one
  • [DisableKeyboardInputTrait](./emoji/src/main/kotlin/com/vanniktech/emoji/traits/DisableKeyboardInputTrait.kt) disable input of the normal soft keyboard
  • [SearchInPlaceTrait](./emoji/src/main/kotlin/com/vanniktech/emoji/traits/SearchInPlaceTrait.kt) search for an emoji using :query
  • [EmojiView](emoji/src/main/java/com/vanniktech/emoji/EmojiView.kt) View of all emojis and categories which does not depend on a keyboard
  • EmojiEditText#disableKeyboardInput() to disable normal keyboard input. To undo call #enableKeyboardInput()

Most of them are also showcased in the sample app.

Snapshots

This library is also distributed as a SNAPSHOT, if you like to check out the latest features.

Note: The API is not stable and may change and break your code at any time if you use a SNAPSHOT.

Add this to your repositories:

maven { url "https://oss.sonatype.org/content/repositories/snapshots" }

And one of these to your dependencies:

implementation "com.vanniktech:emoji:0.13.0-SNAPSHOT"
implementation "com.vanniktech:emoji-ios:0.13.0-SNAPSHOT"
implementation "com.vanniktech:emoji-google:0.13.0-SNAPSHOT"
implementation "com.vanniktech:emoji-twitter:0.13.0-SNAPSHOT"
implementation "com.vanniktech:emoji-facebook:0.13.0-SNAPSHOT"
implementation "com.vanniktech:emoji-material:0.13.0-SNAPSHOT"

Proguard

No configuration needed.

License

Copyright (C) 2016 - Niklas Baudy, Ruben Gees, Mario Đanić and contributors

Licensed under the Apache License, Version 2.0


*Note that all licence references and agreements mentioned in the Emoji README section above are relevant to that project's source code only.