Android自定義控件之自定義組合控件

時間 2019-11-19

標籤 android 自定義控件組合欄目 Android 简体版

原文原文鏈接

前言：

前兩篇介紹了自定義控件的基礎原理Android自定義控件之基本原理（一）、自定義屬性Android自定義控件之自定義屬性（二）。今天重點介紹一下如何經過自定義組合控件來提升佈局的複用，下降開發成本，以及維護成本。html

自定義控件相關文章地址：android

使用自定義組合控件的好處？

咱們在項目開發中常常會碰見不少類似或者相同的佈局，好比APP的標題欄，咱們從三種方式實現標題欄來對比自定義組件帶來的好處，畢竟好的東西仍是以提升開發效率，下降開發成本爲導向的。app

1.）第一種方式：直接在每一個xml佈局中寫相同的標題欄佈局代碼

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:lee="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <RelativeLayout
        android:layout_width="match_parent"
        android:background="@color/green"
        android:layout_height="45dp">

        <Button
            android:id="@+id/title_bar_left"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentLeft="true"
            android:layout_centerVertical="true"
            android:layout_marginLeft="5dp"
            android:background="@mipmap/titlebar_back_icon"
            android:minHeight="45dp"
            android:minWidth="45dp"
            android:textSize="14sp" />

        <TextView
            android:id="@+id/title_bar_title"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:text="登陸"
            android:singleLine="true"
            android:textSize="17sp" />

        <Button
            android:id="@+id/title_bar_right"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_centerVertical="true"
            android:layout_marginRight="7dp"
            android:text="提交"
            android:textColor="@android:color/white"
            android:background="@null"
            android:minHeight="45dp"
            android:minWidth="45dp"
            android:textSize="14sp" />
    </RelativeLayout>

</LinearLayout>

這種方式沒有任何佈局複用的概念，同時也讓當前的佈局變得臃腫難以維護，開發效率低下，並且這個還須要要求每一個開發人員必須細心不然有可能會作出良莠不齊的標題欄，因此這種方式是最不推薦使用的。佈局

2.）第二種方式：使用include標籤

首先定義標題欄佈局post

    <RelativeLayout
        android:layout_width="match_parent"
        android:background="@color/green"
        android:layout_height="45dp">

        <Button
            android:id="@+id/title_bar_left"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentLeft="true"
            android:layout_centerVertical="true"
            android:layout_marginLeft="5dp"
            android:minHeight="45dp"
            android:minWidth="45dp"
            android:textSize="14sp" />

        <TextView
            android:id="@+id/title_bar_title"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:singleLine="true"
            android:textSize="17sp" />

        <Button
            android:id="@+id/title_bar_right"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_centerVertical="true"
            android:layout_marginRight="7dp"
            android:background="@null"
            android:minHeight="45dp"
            android:minWidth="45dp"
            android:textSize="14sp" />
    </RelativeLayout>

而後在須要的地方經過include標籤實現引用this

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:lee="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <include layout="@layout/view_title_bar" />

</LinearLayout>

經過上面的佈局代碼，咱們可使用上面這種方式確實實現了佈局的複用，並且也避免了開發人員開發出良莠不齊標題欄的問題，可是同時也引入了新的問題，好比更加下降了開發效率，加大了開發成本，問題就在咱們該如何爲每一個佈局文件定義標題欄？只有經過代碼的方式來設置標題問題，左右按鈕等其餘的屬性，致使佈局屬性和Activity代碼耦合性比較高，因此這種方式也不是推薦的方式。spa

3.）第三種方式：經過自定義組合控件

這裏先不具體介紹如何實現一個自定義組合控件，這裏先介紹一下自定義組合控件帶來的好處。設計

提升佈局文件開發效率
下降佈局文件維護成本
下降佈局文件和Activity代碼耦合性
容易擴展
簡單易用

如何實現一個自定義組合控件

1.）先定義一個佈局文件

<merge xmlns:android="http://schemas.android.com/apk/res/android">

    <Button
        android:id="@+id/title_bar_left"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_centerVertical="true"
        android:layout_marginLeft="5dp"
        android:background="@null"
        android:minHeight="45dp"
        android:minWidth="45dp"
        android:textSize="14sp" />

    <TextView
        android:id="@+id/title_bar_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:singleLine="true"
        android:textSize="17sp" />

    <Button
        android:id="@+id/title_bar_right"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentRight="true"
        android:layout_centerVertical="true"
        android:layout_marginRight="7dp"
        android:background="@null"
        android:minHeight="45dp"
        android:minWidth="45dp"
        android:textSize="14sp" />

</merge>

注意：這裏爲什麼要使用merge標籤，自定義組合控件時會繼承RelativeLayout、LinearLayout等控件，這樣致使佈局的層級無形中增長了一層，以下是對比：code

未使用merge標籤orm

使用merge標籤

2.）定義自定義屬性

好比標題文字、標題欄左邊按鈕圖標等。

 <declare-styleable name="CustomTitleBar">
        <attr name="title_background_color" format="reference|integer" />
        <attr name="left_button_visible" format="boolean" />
        <attr name="right_button_visible" format="boolean" />
        <attr name="title_text" format="string" />
        <attr name="title_text_color" format="color" />
        <attr name="title_text_drawable" format="reference|integer" />
        <attr name="right_button_text" format="string" />
        <attr name="right_button_text_color" format="color" />
        <attr name="right_button_drawable" format="reference|integer" />
        <attr name="left_button_text" format="string" />
        <attr name="left_button_text_color" format="color" />
        <attr name="left_button_drawable" format="reference|integer" />
    </declare-styleable>

3.）自定義一個View根據需求繼承不一樣的ViewGroup子類，好比：RelativeLayout、LinearLayout等，咱們這裏繼承RelativeLayout。

public class CustomTitleBar extends RelativeLayout {
    private  Button titleBarLeftBtn;
    private Button titleBarRightBtn;
    private TextView titleBarTitle;

    public CustomTitleBar(Context context, AttributeSet attrs) {
        super(context, attrs);
        LayoutInflater.from(context).inflate(R.layout.custom_title_bar, this, true);
        titleBarLeftBtn = (Button) findViewById(R.id.title_bar_left);
        titleBarRightBtn = (Button) findViewById(R.id.title_bar_right);
        titleBarTitle = (TextView) findViewById(R.id.title_bar_title);

        TypedArray attributes = context.obtainStyledAttributes(attrs, R.styleable.CustomTitleBar);
        if (attributes != null) {
            //處理titleBar背景色
            int titleBarBackGround = attributes.getResourceId(R.styleable.CustomTitleBar_tlb_title_background_color, Color.GREEN);
            setBackgroundResource(titleBarBackGround);
            //先處理左邊按鈕
            //獲取是否要顯示左邊按鈕
            boolean leftButtonVisible = attributes.getBoolean(R.styleable.CustomTitleBar_tlb_left_button_visible, true);
            if (leftButtonVisible) {
                titleBarLeftBtn.setVisibility(View.VISIBLE);
            } else {
                titleBarLeftBtn.setVisibility(View.INVISIBLE);
            }
            //設置左邊按鈕的文字
            String leftButtonText = attributes.getString(R.styleable.CustomTitleBar_tlb_left_button_text);
            if (!TextUtils.isEmpty(leftButtonText)) {
                titleBarLeftBtn.setText(leftButtonText);
                //設置左邊按鈕文字顏色
                int leftButtonTextColor = attributes.getColor(R.styleable.CustomTitleBar_tlb_left_button_text_color, Color.WHITE);
                titleBarLeftBtn.setTextColor(leftButtonTextColor);
            }
            //設置左邊圖片icon 這裏是二選一 要麼只能是文字 要麼只能是圖片
            int leftButtonDrawable = attributes.getResourceId(R.styleable.CustomTitleBar_tlb_left_button_drawable, R.mipmap.titlebar_back_icon);
            if (leftButtonDrawable != -1) {
                titleBarLeftBtn.setCompoundDrawablesWithIntrinsicBounds(leftButtonDrawable, 0, 0, 0);  //設置到哪一個控件的位置（）
            }


            //處理標題
            //先獲取標題是否要顯示圖片icon
            int titleTextDrawable = attributes.getResourceId(R.styleable.CustomTitleBar_tlb_title_text_drawable, -1);
            if (titleTextDrawable != -1) {
                titleBarTitle.setBackgroundResource(titleTextDrawable);
            } else {
                //若是不是圖片標題 則獲取文字標題
                String titleText = attributes.getString(R.styleable.CustomTitleBar_tlb_title_text);
                if (!TextUtils.isEmpty(titleText)) {
                    titleBarTitle.setText(titleText);
                }
                //獲取標題顯示顏色
                int titleTextColor = attributes.getColor(R.styleable.CustomTitleBar_tlb_title_text_color, Color.WHITE);
                titleBarTitle.setTextColor(titleTextColor);
            }

            //先處理右邊按鈕
            //獲取是否要顯示右邊按鈕
            boolean rightButtonVisible = attributes.getBoolean(R.styleable.CustomTitleBar_tlb_right_button_visible, true);
            if (rightButtonVisible) {
                titleBarRightBtn.setVisibility(View.VISIBLE);
            } else {
                titleBarRightBtn.setVisibility(View.INVISIBLE);
            }
            //設置右邊按鈕的文字
            String rightButtonText = attributes.getString(R.styleable.CustomTitleBar_tlb_right_button_text);
            if (!TextUtils.isEmpty(rightButtonText)) {
                titleBarRightBtn.setText(rightButtonText);
                //設置右邊按鈕文字顏色
                int rightButtonTextColor = attributes.getColor(R.styleable.CustomTitleBar_tlb_right_button_text_color, Color.WHITE);
                titleBarRightBtn.setTextColor(rightButtonTextColor);
            }
            //設置右邊圖片icon 這裏是二選一 要麼只能是文字 要麼只能是圖片
            int rightButtonDrawable = attributes.getResourceId(R.styleable.CustomTitleBar_tlb_right_button_drawable, -1);
            if (rightButtonDrawable != -1) {
                titleBarRightBtn.setCompoundDrawablesWithIntrinsicBounds(0, 0, rightButtonDrawable, 0);  //設置到哪一個控件的位置（）
            }
            attributes.recycle();
        }
    }

    public void setTitleClickListener(OnClickListener onClickListener) {
        if (onClickListener != null) {
            titleBarLeftBtn.setOnClickListener(onClickListener);
            titleBarRightBtn.setOnClickListener(onClickListener);
        }
    }

    public Button getTitleBarLeftBtn() {
        return titleBarLeftBtn;
    }

    public Button getTitleBarRightBtn() {
        return titleBarRightBtn;
    }

    public TextView getTitleBarTitle() {
        return titleBarTitle;
    }

}

4.）在不一樣的XML佈局中引用

關於如何使用自定義屬性這裏就再也不說明了，爲了更加直觀的查看效果，我這裏在一個佈局文件中實現不一樣要求的標題欄

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:lee="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.whoislcj.views.CustomTitleBar
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="10dp"
        lee:right_button_drawable="@mipmap/titlebar_add_icon"
        lee:title_background_color="@color/green"
        lee:title_text="標題1" />

    <com.whoislcj.views.CustomTitleBar
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="10dp"
        lee:right_button_visible="false"
        lee:title_background_color="@color/green"
        lee:title_text="標題2" />

    <com.whoislcj.views.CustomTitleBar
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="10dp"
        lee:left_button_text="左邊"
        lee:right_button_text="右邊"
        lee:title_background_color="@color/red"
        lee:title_text="標題3" />

    <com.whoislcj.views.CustomTitleBar
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="10dp"
        lee:left_button_text="左邊"
        lee:right_button_drawable="@mipmap/titlebar_add_icon"
        lee:title_background_color="@color/red"
        lee:title_text="標題4" />

    <com.whoislcj.views.CustomTitleBar
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="10dp"
        lee:left_button_text="左邊"
        lee:left_button_text_color="@color/red"
        lee:right_button_drawable="@mipmap/titlebar_add_icon"
        lee:title_background_color="@color/blue"
        lee:title_text="標題5" />

    <com.whoislcj.views.CustomTitleBar
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="10dp"
        lee:left_button_text="左邊"
        lee:left_button_text_color="@color/red"
        lee:right_button_drawable="@mipmap/titlebar_add_icon"
        lee:title_background_color="@color/blue"
        lee:title_text="標題6"
        lee:title_text_color="@color/black" />

</LinearLayout>

顯示效果

總結：

經過本篇文章咱們得知，經過自定義組合控件確實可以提升開發效率，下降維護成本，可是也須要UI設計風格保持高度一致，否則的話只能呵呵噠了！因此想要作好一個app須要一個有共識的團隊才行。本篇介紹到此爲止，下一篇要更新什麼我尚未想好！有多是自定義控件的事件回調，也有可能自定義ViewGroup實現流式佈局。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。