Android自定義標(biāo)簽列表控件LabelsView解析

無論是在移動(dòng)端的App,還是在前端的網(wǎng)頁纪吮,我們經(jīng)常會(huì)看到下面這種標(biāo)簽的列表效果:


標(biāo)簽列表

標(biāo)簽從左到右擺放,一行顯示不下時(shí)自動(dòng)換行要糊。這樣的效果用Android源生的控件很不好實(shí)現(xiàn),所以往往需要我們自己去自定義控件局劲。我在開發(fā)中就遇到過幾次要實(shí)現(xiàn)這樣的標(biāo)簽列表效果,所以就自己寫了個(gè)控件奶赠,放到我的GitHub鱼填,方便以后使用。有興趣的同學(xué)也歡迎訪問我的GitHub苹丸、查看源碼實(shí)現(xiàn)和使用該控件苇经。下面我將為大家介紹該控件的具體實(shí)現(xiàn)和使用。
要實(shí)現(xiàn)這樣一個(gè)標(biāo)簽列表其實(shí)并不難扇单,列表中的item可以直接用TextView來實(shí)現(xiàn)蜘澜,我們只需要關(guān)心列表控件的大小和標(biāo)簽的擺放就可以了施流。也就是說我們需要做的只要兩件事:測量布局(onMeasure)和擺放標(biāo)簽(onLayout)瞪醋。這是自定義ViewGroup的基本步驟扮碧,相信對自定義View有所了解的同學(xué)都不會(huì)陌生杏糙。下面我們就來看看具體的代碼實(shí)現(xiàn)蚓土。
控件的測量:

    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {

        int count = getChildCount();
        int maxWidth = MeasureSpec.getSize(widthMeasureSpec) - getPaddingLeft() - getPaddingRight();

        int contentHeight = 0; //記錄內(nèi)容的高度
        int lineWidth = 0; //記錄行的寬度
        int maxLineWidth = 0; //記錄最寬的行寬
        int maxItemHeight = 0; //記錄一行中item高度最大的高度
        boolean begin = true; //是否是行的開頭

        //循環(huán)測量item并計(jì)算控件的內(nèi)容寬高
        for (int i = 0; i < count; i++) {
            View view = getChildAt(i);
            measureChild(view, widthMeasureSpec, heightMeasureSpec);

           if(!begin) {
                lineWidth += mWordMargin;
            }else {
                begin = false;
            }
            //當(dāng)前行顯示不下item時(shí)換行蜀漆。
            if (maxWidth <= lineWidth + view.getMeasuredWidth()) {
                contentHeight += mLineMargin;
                contentHeight += maxItemHeight;
                maxItemHeight = 0;
                maxLineWidth = Math.max(maxLineWidth, lineWidth);
                lineWidth = 0;
                begin = true;
            }
            maxItemHeight = Math.max(maxItemHeight, view.getMeasuredHeight());
           
            lineWidth += view.getMeasuredWidth();
        }

        contentHeight += maxItemHeight;
        maxLineWidth = Math.max(maxLineWidth, lineWidth);

        //測量控件的最終寬高
        setMeasuredDimension(measureWidth(widthMeasureSpec,maxLineWidth),
                measureHeight(heightMeasureSpec, contentHeight));

    }

    //測量控件的寬
    private int measureWidth(int measureSpec, int contentWidth) {
        int result = 0;
        int specMode = MeasureSpec.getMode(measureSpec);
        int specSize = MeasureSpec.getSize(measureSpec);

        if (specMode == MeasureSpec.EXACTLY) {
            result = specSize;
        } else {
            result = contentWidth + getPaddingLeft() + getPaddingRight();
            if (specMode == MeasureSpec.AT_MOST) {
                result = Math.min(result, specSize);
            }
        }
        //這一句是為了支持minWidth屬性。
        result = Math.max(result, getSuggestedMinimumWidth());
        return result;
    }

    //測量控件的高
    private int measureHeight(int measureSpec, int contentHeight) {
        int result = 0;
        int specMode = MeasureSpec.getMode(measureSpec);
        int specSize = MeasureSpec.getSize(measureSpec);

        if (specMode == MeasureSpec.EXACTLY) {
            result = specSize;
        } else {
            result = contentHeight + getPaddingTop() + getPaddingBottom();
            if (specMode == MeasureSpec.AT_MOST) {
                result = Math.min(result, specSize);
            }
        }
        //這一句是為了支持minHeight屬性绷耍。
        result = Math.max(result, getSuggestedMinimumHeight());
        return result;
    }

標(biāo)簽的擺放:

    @Override
    protected void onLayout(boolean changed, int left, int top, int right, int bottom) {

        int x = getPaddingLeft();
        int y = getPaddingTop();

        int contentWidth = right - left;
        int maxItemHeight = 0;

        int count = getChildCount();
        //循環(huán)擺放item
        for (int i = 0; i < count; i++) {
            View view = getChildAt(i);

            //當(dāng)前行顯示不下item時(shí)換行鲜侥。
            if (contentWidth < x + view.getMeasuredWidth() + getPaddingRight()) {
                x = getPaddingLeft();
                y += mLineMargin;
                y += maxItemHeight;
                maxItemHeight = 0;
            }
            view.layout(x, y, x + view.getMeasuredWidth(), y + view.getMeasuredHeight());
            x += view.getMeasuredWidth();
            x += mWordMargin;
            maxItemHeight = Math.max(maxItemHeight, view.getMeasuredHeight());
        }
    }

onMeasure和onLayout的實(shí)現(xiàn)代碼基本是一樣的描函,不同的只是一個(gè)是測量寬高,一個(gè)是擺放位置而已舀寓。實(shí)現(xiàn)起來非常的簡單互墓。
以上是LabelsView的核心代碼,LabelsView除了實(shí)現(xiàn)了item的測量和擺放以外篡撵,還提供了一系列的方法讓使用者可以方便設(shè)置標(biāo)簽的樣式(包括標(biāo)簽被選中的樣式)和標(biāo)簽點(diǎn)擊、選中的監(jiān)聽等骂租。下面LabelsView的使用介紹斑司。

1但汞、引入依賴
在Project的build.gradle在添加以下代碼

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

在Module的build.gradle在添加以下代碼

dependencies {
    compile 'com.github.donkingliang:LabelsView:1.4.1'
}

2、編寫布局:

   <com.donkingliang.labels.LabelsView 
       xmlns:app="http://schemas.android.com/apk/res-auto"
       android:id="@+id/labels"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       app:labelBackground="@drawable/label_bg"     //標(biāo)簽的背景
       app:labelTextColor="@drawable/label_text_color" //標(biāo)簽的字體顏色 可以是一個(gè)顏色值
       app:labelTextSize="14sp"      //標(biāo)簽的字體大小
       app:labelTextPaddingBottom="5dp"   //標(biāo)簽的上下左右邊距
       app:labelTextPaddingLeft="10dp"
       app:labelTextPaddingRight="10dp"
       app:labelTextPaddingTop="5dp"
       app:lineMargin="10dp"   //行與行的距離
       app:wordMargin="10dp"   //標(biāo)簽與標(biāo)簽的距離
       app:selectType="SINGLE"   //標(biāo)簽的選擇類型 有單選(可反選)僵缺、單選(不可反選)磕潮、多選、不可選四種類型
       app:maxSelect="5" />  //標(biāo)簽的最大選擇數(shù)量自脯,只有多選的時(shí)候才有用,0為不限數(shù)量

這里有兩個(gè)地方需要說明一下:

1)標(biāo)簽的正常樣式和選中樣式是通過drawable來實(shí)現(xiàn)的锻狗。比如下面兩個(gè)drawable焕参。

<!-- 標(biāo)簽的背景 label_bg -->
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 標(biāo)簽選中時(shí)的背景 -->
    <item android:state_selected="true">
        <shape>
            <stroke android:width="2dp" android:color="#fb435b" />
            <corners android:radius="8dp" />
            <solid android:color="@android:color/white" />
        </shape>
    </item>
    <!-- 標(biāo)簽的正常背景 -->
    <item>
        <shape>
            <stroke android:width="2dp" android:color="#656565" />
            <corners android:radius="8dp" />
            <solid android:color="@android:color/white" />
        </shape>
    </item>
</selector>
<!-- 標(biāo)簽的文字顏色 label_text_color -->
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 標(biāo)簽選中時(shí)的文字顏色 -->
    <item android:color="#fb435b" android:state_selected="true" />
    <!-- 標(biāo)簽的正常文字顏色 -->
    <item android:color="#2d2b2b" />
</selector>

TextView的textColor屬性除了可以設(shè)置一個(gè)顏色值以外叠纷,也可以通過資源來設(shè)置的,這一點(diǎn)很多同學(xué)都不知道涩嚣。

2)標(biāo)簽的選擇類型有四種:

NONE :標(biāo)簽不可選中缓艳,也不響應(yīng)選中事件監(jiān)聽,這是默認(rèn)值阶淘。

SINGLE:單選(可反選)。這種模式下坤塞,可以一個(gè)也不選澈蚌。

SINGLE_IRREVOCABLY:單選(不可反選)。這種模式下浮禾,有且只有一個(gè)是選中的份汗。默認(rèn)是第一個(gè)。

MULTI:多選匆帚,可以通過設(shè)置maxSelect限定選擇的最大數(shù)量旁钧,0為不限數(shù)量互拾。maxSelect只有在多選的時(shí)候才有效嚎幸。多選模式下可以設(shè)置一些標(biāo)簽為必選項(xiàng)。必選項(xiàng)的標(biāo)簽?zāi)J(rèn)選中或衡,且不能取消车遂。

3、設(shè)置標(biāo)簽:

labelsView = (LabelsView) findViewById(labels);
ArrayList<String> label = new ArrayList<>();
label.add("Android");
label.add("IOS");
label.add("前端");
label.add("后臺(tái)");
label.add("微信開發(fā)");
label.add("游戲開發(fā)");
labelsView.setLabels(label); //直接設(shè)置一個(gè)字符串?dāng)?shù)組就可以了坡疼。

//LabelsView可以設(shè)置任何類型的數(shù)據(jù)衣陶,而不僅僅是String。
ArrayList<TestBean> testList = new ArrayList<>();
testList.add(new TestBean("Android",1));
testList.add(new TestBean("IOS",2));
testList.add(new TestBean("前端",3));
testList.add(new TestBean("后臺(tái)",4));
testList.add(new TestBean("微信開發(fā)",5));
testList.add(new TestBean("游戲開發(fā)",6));
labelsView.setLabels(testList, new LabelsView.LabelTextProvider<TestBean>() {
    @Override
    public CharSequence getLabelText(TextView label, int position, TestBean data) {
        //根據(jù)data和position返回label需要顯示的數(shù)據(jù)教沾。
        return data.getName();
    }
});

4译断、設(shè)置事件監(jiān)聽:(如果需要的話)

//標(biāo)簽的點(diǎn)擊監(jiān)聽
labelsView.setOnLabelClickListener(new LabelsView.OnLabelClickListener() {
    @Override
    public void onLabelClick(TextView label, Object data, int position) {
         //label是被點(diǎn)擊的標(biāo)簽,data是標(biāo)簽所對應(yīng)的數(shù)據(jù)堪唐,position是標(biāo)簽的位置翎蹈。
    }
});
//標(biāo)簽的選中監(jiān)聽
labelsView.setOnLabelSelectChangeListener(new LabelsView.OnLabelSelectChangeListener() {
    @Override
    public void onLabelSelectChange(TextView label, Object data, boolean isSelect, int position) {
        //label是被選中的標(biāo)簽,data是標(biāo)簽所對應(yīng)的數(shù)據(jù)合陵,isSelect是是否選中逞力,position是標(biāo)簽的位置。
    }
});

5、常用方法

//設(shè)置選中標(biāo)簽执隧。
//positions是個(gè)可變類型户侥,表示被選中的標(biāo)簽的位置峦嗤。
//比喻labelsView.setSelects(1,2,5);選中第1,3,5個(gè)標(biāo)簽烁设。如果是單選的話,只有第一個(gè)參數(shù)有效装黑。
public void setSelects(int... positions);
public void setSelects(List<Integer> positions);

//獲取選中的標(biāo)簽(返回的是所有選中的標(biāo)簽的位置)糠睡。返回的是一個(gè)Integer的數(shù)組疚颊,表示被選中的標(biāo)簽的下標(biāo)。如果沒有選中均抽,數(shù)組的size等于0其掂。
public ArrayList<Integer> getSelectLabels();
//獲取選中的label(返回的是所有選中的標(biāo)簽的數(shù)據(jù))。如果沒有選中喘漏,數(shù)組的size等于0华烟。T表示標(biāo)簽的數(shù)據(jù)類型。
public <T> List<T> getSelectLabelDatas();

//取消所有選中的標(biāo)簽负饲。
public void clearAllSelect();

//設(shè)置標(biāo)簽的選擇類型喂链,有NONE、SINGLE洞坑、SINGLE_IRREVOCABLY和MULTI四種類型蝇率。
public void setSelectType(SelectType selectType);

//設(shè)置最大的選擇數(shù)量刽沾,只有selectType等于MULTI是有效排拷。
public void setMaxSelect(int maxSelect);

//設(shè)置必選項(xiàng),只有在多項(xiàng)模式下布蔗,這個(gè)方法才有效
public void setCompulsorys(int... positions)
public void setCompulsorys(List<Integer> positions)

//清空必選項(xiàng)浪腐,只有在多項(xiàng)模式下,這個(gè)方法才有效
public void clearCompulsorys()

//設(shè)置標(biāo)簽背景
public void setLabelBackgroundResource(int resId);

//設(shè)置標(biāo)簽的文字顏色
public void setLabelTextColor(int color);
public void setLabelTextColor(ColorStateList color);

//設(shè)置標(biāo)簽的文字大新饽小(單位是px)
public void setLabelTextSize(float size);

//設(shè)置標(biāo)簽內(nèi)邊距
public void setLabelTextPadding(int left, int top, int right, int bottom);

//設(shè)置行間隔
public void setLineMargin(int margin);

//設(shè)置標(biāo)簽的間隔
public void setWordMargin(int margin);

所有的set方法都有對應(yīng)的get方法傍睹,這里就不說了。

效果圖:

效果圖.gif

最后給出該控件在GitHub中的地址吮炕,歡迎大家訪問和使用访得。
https://github.com/donkingliang/LabelsView

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末悍抑,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子拂盯,更是在濱河造成了極大的恐慌记靡,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,406評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件空凸,死亡現(xiàn)場離奇詭異寸痢,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)两嘴,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,732評論 3 393
  • 文/潘曉璐 我一進(jìn)店門族壳,熙熙樓的掌柜王于貴愁眉苦臉地迎上來仿荆,“玉大人,你說我怎么就攤上這事拢操。” “怎么了杠园?”我有些...
    開封第一講書人閱讀 163,711評論 0 353
  • 文/不壞的土叔 我叫張陵舔庶,是天一觀的道長惕橙。 經(jīng)常有香客問我,道長弥鹦,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,380評論 1 293
  • 正文 為了忘掉前任朦促,我火速辦了婚禮务冕,結(jié)果婚禮上混滔,老公的妹妹穿的比我還像新娘。我一直安慰自己坯屿,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,432評論 6 392
  • 文/花漫 我一把揭開白布乏德。 她就那樣靜靜地躺著喊括,像睡著了一般。 火紅的嫁衣襯著肌膚如雪郑什。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,301評論 1 301
  • 那天钝满,我揣著相機(jī)與錄音申窘,去河邊找鬼。 笑死碎捺,一個(gè)胖子當(dāng)著我的面吹牛贷洲,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播帽氓,決...
    沈念sama閱讀 40,145評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼俩块,長吁一口氣:“原來是場噩夢啊……” “哼玉凯!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起漫仆,我...
    開封第一講書人閱讀 39,008評論 0 276
  • 序言:老撾萬榮一對情侶失蹤盲厌,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后吗浩,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,443評論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡禁荸,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,649評論 3 334
  • 正文 我和宋清朗相戀三年赶熟,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片间坐。...
    茶點(diǎn)故事閱讀 39,795評論 1 347
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡啊央,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情浴骂,我是刑警寧澤,帶...
    沈念sama閱讀 35,501評論 5 345
  • 正文 年R本政府宣布趣苏,位于F島的核電站梯轻,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏喳挑。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,119評論 3 328
  • 文/蒙蒙 一单绑、第九天 我趴在偏房一處隱蔽的房頂上張望曹宴。 院中可真熱鬧,春花似錦区转、人聲如沸版扩。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,731評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至诀豁,卻和暖如春窥妇,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背活翩。 一陣腳步聲響...
    開封第一講書人閱讀 32,865評論 1 269
  • 我被黑心中介騙來泰國打工材泄, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人拉宗。 一個(gè)月前我還...
    沈念sama閱讀 47,899評論 2 370
  • 正文 我出身青樓旦事,卻偏偏與公主長得像,于是被迫代替她去往敵國和親姐浮。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,724評論 2 354

推薦閱讀更多精彩內(nèi)容