Selektor emotikonów to interfejs, który zapewnia nowoczesny wygląd i styl, aktualne emotikony oraz łatwość obsługi. Użytkownicy mogą przeglądać i wybierać emotikony oraz ich warianty lub wybierać te, które były ostatnio używane.
Dzięki tej bibliotece aplikacje z różnych źródeł mogą zapewniać użytkownikom spójną i inkluzywną obsługę bez konieczności tworzenia i utrzymywania od podstaw własnego selektora emotikonów.
Funkcje
Aktualne emotikony
Niedawno opublikowane emotikony są dodawane do selektora emotikonów. Biblioteka selektora emotikonów jest zgodna z różnymi wersjami Androida i urządzeń.
Wersje przyklejone
Przytrzymaj emotikon, aby wyświetlić menu wariantów, np. różne płcie lub odcienie skóry. Wybrany wariant jest zapisywany w selektorze emotikonów, a ostatnio wybrany wariant jest używany w panelu głównym.
Dzięki tej funkcji użytkownicy mogą wysyłać preferowane warianty emotikon jednym kliknięciem.
![warianty emotikonów](https://developer.android.com/static/images/develop/ui/views/text-and-emoji/emoji-variants.png?authuser=7&hl=pl)
Najnowsze emotikony
![najnowsze emotikony](https://developer.android.com/static/images/develop/ui/views/text-and-emoji/recent-emoji.png?authuser=7&hl=pl)
RecentEmojiProvider
odpowiada za udostępnianie emotikonów z kategorii Ostatnio używane. W bibliotece jest domyślnego dostawcę emotikonów,
który spełnia najczęstszy przypadek użycia:
- Wszystkie wybrane emotikony są zapisywane w ustawieniach wspólnych dla poszczególnych aplikacji.
- Selektor wyświetla maksymalnie 3 wiersze wybranych emotikonów (z usuniętymi duplikatami) w odwrotnej kolejności chronologicznej.
Jeśli to domyślne działanie jest wystarczające, nie musisz używać setRecentEmojiProvider()
.
Może być jednak konieczne dostosowanie działania dostawcy. Oto kilka typowych scenariuszy:
- Chcesz przechowywać różne wybrane emotikony na poszczególnych kontach użytkowników.
- Chcesz używać pamięci masowej innych niż ustawienia wspólne.
- Chcesz wyświetlić ostatnie emotikony posortowane według częstotliwości.
Następnie możesz zaimplementować interfejs RecentEmojiProvider
i skonfigurować go za pomocą setRecentEmojiProvider()
.
Zgodność z EmojiCompat
Jeśli ta opcja jest włączona, wystąpienie EmojiCompat
jest używane w selektorze emotikonów do renderowania jak największej liczby emotikonów. Selektor emotikonów nie wymaga jednak parametru EmojiCompat
.
Wymagania wstępne
Aplikacja musi być kierowana na Androida 5.0 (poziom interfejsu API 21) lub nowszego.
Korzystanie z biblioteki
Zaimportuj
androidx.emoji2:emojipicker:$version
do plikubuild.gradle
aplikacji.dependencies { implementation "androidx.emoji2:emojipicker:$version" }
Rozszerz widok selektora emotikonów i opcjonalnie ustaw
emojiGridRows
orazemojiGridColumns
.- Wartość domyślna parametru
emojiGridColumns
to 9. - Liczba wierszy jest obliczana na podstawie wysokości widoku nadrzędnego i wartości
emojiGridColumns
. - Użyj wartości zmiennoprzecinkowej
emojiGridRows
, aby wskazać, że użytkownik może przewinąć ekran w dół, aby zobaczyć więcej emotikonów.
<androidx.emoji2.emojipicker.EmojiPickerView android:id="@+id/emoji_picker" android:layout_width="match_parent" android:layout_height="match_parent" app:emojiGridColumns="9" />
val emojiPickerView = EmojiPickerView(context).apply { emojiGridColumns = 15 layoutParams = ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT ) } findViewById<ViewGroup>(R.id.emoji_picker_layout).addView(emojiPickerView)
- Wartość domyślna parametru
Użyj
setOnEmojiPickedListener()
, aby dołączyć wybrane emotikony do widoku. Aby na przykład dołączyć do elementuEditText
, wykonaj te czynności:emojiPickerView.setOnEmojiPickedListener { findViewById<EditText>(R.id.edit_text).append(it.emoji) }
Opcjonalnie ustaw
RecentEmojiProvider
. Przykład implementacji znajdziesz w przykładowej aplikacji.Opcjonalnie dostosuj style. Utwórz własny styl, aby zastąpić wspólne atrybuty motywu i zastosować go do
EmojiPickerView
. Na przykład zastąpienie atrybutucolorControlNormal
zmienia kolor ikony kategorii.<style name="CustomStyle" > <item name="colorControlNormal">#FFC0CB</item> </style> <androidx.emoji2.emojipicker.EmojiPickerView android:id="@+id/emoji_picker" android:layout_width="match_parent" android:layout_height="match_parent" android:theme="@style/CustomStyle" app:emojiGridColumns="9" />
Przykładowa aplikacja
Przykładowa aplikacja do wyboru emotikonów pokazuje podstawowe przypadki użycia oraz dodatkowo te dodatkowe scenariusze:
- Ponowne obliczenie układu po zresetowaniu elementów
emojiGridRows
lubemojiGridColumns
. - Zastąpiony dostawca emotikonów, który sortuje według częstotliwości.
- Dodatkowe dostosowywanie stylu.