自定义控件Topbar 升级版

Mr_Leixiansheng

已于 2023-06-29 16:39:44 修改

阅读量401

点赞数

分类专栏：自定义控件文章标签： gitee android java

于 2017-07-07 17:01:32 首次发布

本文链接：https://blog.csdn.net/Mr_Leixiansheng/article/details/74738960

版权

自定义控件专栏收录该内容

17 篇文章 1 订阅

订阅专栏

转载请注明出处：自定义控件Topbar 升级版_Mr_Leixiansheng的博客-CSDN博客

前言：

使用自定义组合控件的好处？

我们在项目开发中经常会遇见很多相似或者相同的布局，比如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标签

首先定义标题栏布局

    <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标签实现引用

 <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代码耦合性比较高，所以这种方式也不是推荐的方式。

3.）第三种方式：通过自定义组合控件

这里先不具体介绍如何实现一个自定义组合控件，这里先介绍一下自定义组合控件带来的好处。

提高布局文件开发效率
降低布局文件维护成本
降低布局文件和Activity代码耦合性
容易扩展
简单易用

如何实现一个自定义组合控件

1.）先定义一个布局文件

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

    <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等控件，这样导致布局的层级无形中增加了一层，如下是对比：

未使用merge标签

使用merge标签

2.）定义自定义属性

比如标题文字、标题栏左边按钮图标等。values-->attrs

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <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" />
        <attr name="backgroundColor" format="color"/>
    </declare-styleable>
</resources>

3.）自定义一个View根据需求继承不同的ViewGroup子类，比如：RelativeLayout、LinearLayout等，我们这里继承RelativeLayout。

 private Button titleBarLeftBtn;
    private Button titleBarRightBtn;
    private TextView titleBarTitle;

    private int backgroundColor;

    //title属性
    private int titleTextDrawable;
    private String titleText;
    private int titleTextColor;

    //leftBtn属性
    private boolean leftButtonVisible;
    private String leftButtonText;
    private int leftButtonDrawable;
    private int leftButtonTextColor;


    //leftBtn属性
    private boolean rightButtonVisible;
    private String rightButtonText;
    private int rightButtonDrawable;
    private int rightButtonTextColor;

    private TypedArray attributes;

    public CustomTitleBar(Context context, AttributeSet attrs) {
        super(context, attrs);

        LayoutInflater.from(context).inflate(R.layout.topbar, 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);

        attributes = context.obtainStyledAttributes(attrs, R.styleable.CustomTitleBar);

        if (attributes != null) {

            //获取自定义控件属性
            getAttributes();

            setBackgroundColor(backgroundColor);

            //获取是否要显示左边按钮
            if (leftButtonVisible) {
                titleBarLeftBtn.setVisibility(View.VISIBLE);

                if (!TextUtils.isEmpty(leftButtonText)) {
                    titleBarLeftBtn.setText(leftButtonText);
                    //设置左边按钮文字颜色
                    titleBarLeftBtn.setTextColor(leftButtonTextColor);
                } else {
                    //设置左边图片icon 这里是二选一 要么只能是文字 要么只能是图片
                    if (leftButtonDrawable != -1) {
                        titleBarLeftBtn.setBackgroundResource(leftButtonDrawable);
                    }
                }
            } else {
                titleBarLeftBtn.setVisibility(View.GONE);
            }

            //处理标题
            //先获取标题是否要显示图片icon
            if (titleTextDrawable != -1) {
                titleBarTitle.setBackgroundResource(titleTextDrawable);
            } else {
                //如果不是图片标题 则获取文字标题

                if (!TextUtils.isEmpty(titleText)) {
                    titleBarTitle.setText(titleText);
                }
                //获取标题显示颜色
                titleBarTitle.setTextColor(titleTextColor);
            }

            //获取是否要显示右边按钮
            if (rightButtonVisible) {
                titleBarRightBtn.setVisibility(View.VISIBLE);
                if (!TextUtils.isEmpty(rightButtonText)) {
                    titleBarRightBtn.setText(rightButtonText);
                    //设置右边按钮文字颜色

                    titleBarRightBtn.setTextColor(rightButtonTextColor);
                } else {
                    //设置右边图片icon 这里是二选一 要么只能是文字 要么只能是图片
                    if (rightButtonDrawable != -1) {
                        titleBarRightBtn.setBackgroundResource(rightButtonDrawable);
                    }
                }
            } else {
                titleBarRightBtn.setVisibility(View.GONE);
            }
            attributes.recycle();
        }
    }

    public void getAttributes() {
        backgroundColor = attributes.getColor(R.styleable.CustomTitleBar_backgroundColor, Color.GREEN);

        leftButtonVisible = attributes.getBoolean(R.styleable.CustomTitleBar_left_button_visible, true);
        leftButtonText = attributes.getString(R.styleable.CustomTitleBar_left_button_text);
        leftButtonTextColor = attributes.getColor(R.styleable.CustomTitleBar_left_button_text_color, Color.WHITE);
        leftButtonDrawable = attributes.getResourceId(R.styleable.CustomTitleBar_left_button_drawable, R.mipmap.ic_launcher);

        titleTextDrawable = attributes.getResourceId(R.styleable.CustomTitleBar_title_text_drawable, -1);
        titleText = attributes.getString(R.styleable.CustomTitleBar_title_text);
        titleTextColor = attributes.getColor(R.styleable.CustomTitleBar_title_text_color, Color.WHITE);

        rightButtonVisible = attributes.getBoolean(R.styleable.CustomTitleBar_right_button_visible, true);
        rightButtonText = attributes.getString(R.styleable.CustomTitleBar_right_button_text);
        rightButtonTextColor = attributes.getColor(R.styleable.CustomTitleBar_right_button_text_color, Color.WHITE);
        rightButtonDrawable = attributes.getResourceId(R.styleable.CustomTitleBar_right_button_drawable, -1);
    }

    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;
    }

关于如何使用自定义属性这里就不再说明了，为了更加直观的查看效果，我这里在一个布局文件中实现不同要求的标题栏

<?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:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.leixiansheng.newtopbar.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.leixiansheng.newtopbar.CustomTitleBar>

    <com.leixiansheng.newtopbar.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.leixiansheng.newtopbar.CustomTitleBar>

    <com.leixiansheng.newtopbar.CustomTitleBar
        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.leixiansheng.newtopbar.CustomTitleBar>

    <com.leixiansheng.newtopbar.CustomTitleBar
        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.leixiansheng.newtopbar.CustomTitleBar>

    <com.leixiansheng.newtopbar.CustomTitleBar
        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.leixiansheng.newtopbar.CustomTitleBar>

    <com.leixiansheng.newtopbar.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" >
    </com.leixiansheng.newtopbar.CustomTitleBar>

</LinearLayout>

显示效果

总结：

通过本篇文章我们得知，通过自定义组合控件确实能够提高开发效率，降低维护成本，但是也需要UI设计风格保持高度一致，不然的话只能呵呵哒了！所以想要做好一个app需要一个有共识的团队才行。本篇介绍到此为止，下一篇要更新什么我还没有想好！有可能是自定义控件的事件回调，也有可能自定义ViewGroup实现流式布局。

Mr_Leixiansheng

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
自定义控件Topbar 升级版

前言：使用自定义组合控件的好处？我们在项目开发中经常会遇见很多相似或者相同的布局，比如APP的标题栏，我们从三种方式实现标题栏来对比自定义组件带来的好处，毕竟好的东西还是以提高开发效率，降低开发成本为导向的。1.）第一种方式：直接在每个xml布局中写相同的标题栏布局代码xml version="1.0" encoding="utf-8"?>LinearLayout x
复制链接

扫一扫