AutoLabelUI事件回調(diào)指南4大監(jiān)聽器一次搞懂標(biāo)簽的點(diǎn)擊、刪除、已滿與清空【免費(fèi)下載鏈接】AutoLabelUIAndroid library to place labels next to another. If there is not enough space for the next label, it will be added in a new line.項(xiàng)目地址: https://gitcode.com/gh_mirrors/au/AutoLabelUIAutoLabelUI 是一款輕量級(jí) Android 標(biāo)簽庫(kù)能把標(biāo)簽Label橫向排布、空間不足時(shí)自動(dòng)換行。本文帶你一次搞懂它的4 大事件回調(diào)監(jiān)聽器標(biāo)簽被點(diǎn)擊、標(biāo)簽被刪除、標(biāo)簽達(dá)到上限、標(biāo)簽全部清空幫你快速實(shí)現(xiàn)點(diǎn)選-移除-提醒這類交互邏輯。先認(rèn)識(shí) AutoLabelUI一行代碼搞定標(biāo)簽流在布局 XML 中加入AutoLabelUI控件后通過addLabel(標(biāo)簽文字)即可不斷添加標(biāo)簽控件自動(dòng)完成排布與換行每個(gè)標(biāo)簽右上角還可以顯示一個(gè)×小圖標(biāo)點(diǎn)擊即可刪除。核心類源碼位置library/src/main/java/com/dpizarro/autolabel/library/AutoLabelUI.java單個(gè)標(biāo)簽視圖實(shí)現(xiàn)library/src/main/java/com/dpizarro/autolabel/library/Label.java要讓界面響應(yīng)這些操作AutoLabelUI 提供了4 個(gè)監(jiān)聽器接口分別對(duì)應(yīng) 4 類關(guān)鍵時(shí)機(jī)監(jiān)聽器設(shè)置方法觸發(fā)時(shí)機(jī)回調(diào)參數(shù)? OnLabelClickListenersetOnLabelClickListener用戶點(diǎn)擊標(biāo)簽本體被點(diǎn)擊的 Label? OnRemoveLabelListenersetOnRemoveLabelListener標(biāo)簽被刪除點(diǎn)擊 × 圖標(biāo)被刪的 Label 位置 position?? OnLabelsCompletedListenersetOnLabelsCompletedListener標(biāo)簽數(shù)量已滿再添加被拒絕無 OnLabelsEmptyListenersetOnLabelsEmptyListener標(biāo)簽全部清空一個(gè)不剩無監(jiān)聽器一標(biāo)簽點(diǎn)擊OnLabelClickListener當(dāng)用戶點(diǎn)擊標(biāo)簽本身時(shí)觸發(fā)。注意默認(rèn)標(biāo)簽是不可點(diǎn)擊的需要先把label_clickable設(shè)為trueXML 屬性或withLabelsClickables(true)回調(diào)才會(huì)生效。mAutoLabel.setOnLabelClickListener(labelClicked - show(你點(diǎn)了 labelClicked.getText()));在Label.java中可以看到只有l(wèi)abelsClickables為 true 時(shí)標(biāo)簽背景才會(huì)被設(shè)置為可點(diǎn)擊并注冊(cè)點(diǎn)擊監(jiān)聽。監(jiān)聽器二標(biāo)簽刪除OnRemoveLabelListener用戶點(diǎn)擊標(biāo)簽上的 × 圖標(biāo)后標(biāo)簽會(huì)被移除并回調(diào)onRemoveLabel(removedLabel, position)。position來自添加標(biāo)簽時(shí)傳入的位置下標(biāo)如果你用addLabel(文字)這種不帶位置的寫法添加回調(diào)中的 position 會(huì)是-1。適合在這里同步你的數(shù)據(jù)列表或列表項(xiàng)選中狀態(tài)。mAutoLabel.setOnRemoveLabelListener((removedLabel, position) - { if (position ! -1) { adapter.setItemSelected(position, false); // 取消列表中對(duì)應(yīng)項(xiàng)的選中 } });監(jiān)聽器三標(biāo)簽已滿OnLabelsCompletedListener通過max_labels屬性示例布局見app/src/main/res/layout/recyclerview_fragment.xml或setMaxLabels(n)設(shè)定上限后每次添加失敗都會(huì)觸發(fā)一次onLabelsCompleted()——這是給用戶彈 Toast/Snackbar 提示最多只能選 N 個(gè)的最佳時(shí)機(jī)。mAutoLabel.setOnLabelsCompletedListener(() - show(已達(dá)上限));小技巧max_labels設(shè)為 -1 表示不限制數(shù)量此時(shí)該回調(diào)永遠(yuǎn)不會(huì)觸發(fā)。監(jiān)聽器四標(biāo)簽清空OnLabelsEmptyListener只要標(biāo)簽數(shù)量歸零就會(huì)觸發(fā)onLabelsEmpty()。觸發(fā)來源有三種都能感知到逐個(gè)點(diǎn) × 直到刪完調(diào)用removeLabel(文字或位置)程序化刪除至空調(diào)用clear()一鍵清空。常用于復(fù)位界面、恢復(fù)默認(rèn)狀態(tài)或提示當(dāng)前未選擇任何標(biāo)簽。mAutoLabel.setOnLabelsEmptyListener(() - show(已全部清空));實(shí)戰(zhàn)參考示例應(yīng)用如何一次用上 4 個(gè)監(jiān)聽器官方示例中的RecyclerViewFragment完整演示了 4 個(gè)監(jiān)聽器的注冊(cè)方式文件路徑app/src/main/java/com/dpizarro/libraries/autolabelui/RecyclerViewFragment.java點(diǎn)擊列表項(xiàng) →addLabel(姓名, position)添加標(biāo)簽再次點(diǎn)擊 →removeLabel(position)移除標(biāo)簽并由OnRemoveLabelListener同步取消選中態(tài)達(dá)到 10 個(gè)上限 → Snackbar 提示 Completed!全部刪完 → Snackbar 提示 EMPTY!點(diǎn)擊標(biāo)簽本體 → Snackbar 顯示標(biāo)簽文字。這個(gè)列表選擇 標(biāo)簽流 狀態(tài)提示的組合正是 AutoLabelUI 最典型的使用場(chǎng)景照著抄即可上手。常見坑位清單點(diǎn)了標(biāo)簽沒反應(yīng)檢查label_clickable是否開啟library/src/main/res/values/attrs.xml中定義了全部可用屬性。position 為 -1說明該標(biāo)簽是以純文字方式添加的沒有綁定位置下標(biāo)。滿了卻收不到回調(diào)確認(rèn)max_labels已被顯式設(shè)置-1 表示無上限。旋轉(zhuǎn)屏幕后標(biāo)簽還在庫(kù)已內(nèi)置狀態(tài)保存/恢復(fù)無需額外處理。總結(jié)AutoLabelUI 用 4 個(gè)簡(jiǎn)潔的監(jiān)聽器覆蓋了標(biāo)簽交互的全部關(guān)鍵時(shí)機(jī)點(diǎn)擊、刪除、已滿、清空。記住一張表見上文 打開label_clickable你就能用幾行代碼構(gòu)建出響應(yīng)靈敏的標(biāo)簽選擇界面。完整用法可繼續(xù)參考示例工程源碼快速跑通你的第一個(gè)標(biāo)簽流。【免費(fèi)下載鏈接】AutoLabelUIAndroid library to place labels next to another. If there is not enough space for the next label, it will be added in a new line.項(xiàng)目地址: https://gitcode.com/gh_mirrors/au/AutoLabelUI創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考