表情符號挑選器是一項 UI 解決方案,可提供現代外觀和風格、最新的表情符號,而且易於使用。使用者可以瀏覽及選取表情符號和其變化版本,或選擇最近使用的表情符號。
透過這個程式庫,各種來源的應用程式即可為使用者提供一個多元包容的統一表情符號體驗,而開發人員不必從頭開始建構及維護自己的表情符號挑選器。
功能
最新的表情符號
表情符號挑選器會選擇性加入新推出的表情符號。表情符號挑選器程式庫與多種 Android 版本和裝置相容。
固定式變化版本
長按表情符號即可顯示子類選單,例如不同性別或膚色。您選擇的變化版本會儲存在表情符號挑選器中,主面板則會使用最後一個選取的變化版本。
透過這項功能,使用者輕觸一下即可傳送偏好的表情符號變化版本。
最近使用的表情符號
RecentEmojiProvider
負責在「最近使用」類別中提供表情符號。程式庫提供近期預設的表情符號提供者,符合最常見的用途:
- 所有選取的表情符號都會儲存在共用偏好設定中。
- 挑選器最多會顯示 3 列選取的表情符號 (已刪除重複內容),並按時間先後順序顯示。
如果這個預設行為已足夠,您不需要使用 setRecentEmojiProvider()
。
不過,您可能需要自訂提供者行為。以下列舉幾個常見情況:
- 您想為每個使用者帳戶儲存不同的表情符號。
- 您想要使用共用偏好設定以外的資料儲存空間。
- 您想要依頻率排序最近使用的表情符號。
接著,您可以實作 RecentEmojiProvider
介面,並使用 setRecentEmojiProvider()
進行設定。
與 EmojiCompat
的相容性
啟用後,表情符號挑選器會使用 EmojiCompat
例項,盡可能顯示最多表情符號。不過,表情符號挑選器不需要使用 EmojiCompat
。
必要條件
您的應用程式必須指定 Android 5.0 (API 級別 21) 以上版本。
使用程式庫
在應用程式的
build.gradle
檔案中匯入androidx.emoji2:emojipicker:$version
。dependencies { implementation "androidx.emoji2:emojipicker:$version" }
加載表情符號挑選器檢視畫面,並視需要設定
emojiGridRows
和emojiGridColumns
。emojiGridColumns
的預設數量為 9。- 資料列數是根據父項檢視畫面高度和
emojiGridColumns
的值計算而得。 - 使用
emojiGridRows
的浮點值,表示使用者可以向下捲動以查看更多表情符號。
<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)
使用
setOnEmojiPickedListener()
將所選表情符號附加至檢視區塊。舉例來說,如要附加至EditText
,請執行下列步驟:emojiPickerView.setOnEmojiPickedListener { findViewById<EditText>(R.id.edit_text).append(it.emoji) }
視需要設定
RecentEmojiProvider
,請參閱範例應用程式,查看實作範例。視需要自訂樣式。建立自己的樣式來覆寫常見主題屬性,並將樣式套用至
EmojiPickerView
。舉例來說,覆寫colorControlNormal
會變更類別圖示顏色。<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" />
範例應用程式
表情符號挑選器範例應用程式示範基本用途以及其他情境:
- 重設
emojiGridRows
或emojiGridColumns
時,版面配置重新計算。 - 已覆寫近期的表情符號提供者,可以按照頻率排序。
- 其他樣式自訂。