Android开发技巧——自定义控件之使用style

2021-10-18 21:54:24

Android开发技巧——自定义控件之使用style

回顾

在上一篇《Android开发技巧——自定义控件之自定义属性》中，我讲到了如何定义属性以及在自定义控件中获取这些属性的值，也提到了关于这些属性除了可以在布局文件中指定之外，也可以在主题中指定。接下来将分享我所了解的关于在主题中指定属性值的两种方式。

在主题中指定属性值

我们在开发过程中，虽然关于自定义控件学会了如何在布局文件中指定它的值，以应对不同的需求。但有时还会遇到这样一种情况：我们希望对某个控件的属性，能够做一个全局的配置，这样我在本项目中使用它的时候，都是同样的表现，而不需要每个布局文件都复制一次属性的值，而在另一个项目中，我们可以进行另一个全局的配置。

属性定义及关于实现的思考

在上一篇中，我们讲到了自定义属性，如下所示：

 <attr name="pwBorderWidth" format="dimension"/>

其中format定义了这个属性的格式，它支持以下这些方式：

boolean 布尔值
color 颜色
dimension 尺寸
enum 枚举
flag 位或运算
float 浮点值
fraction 百分数
integer 整型值
string 字符串
reference 引用某一资源ID

在定义格式时，还可以指定多种格式。比如

 <attr name="pwBorderWidth" format="dimension|reference"/>

而这里要说的就是reference，引用某一资源ID。

我们可以定义一个属性，格式为reference，然后在theme中配置它的值为某个style，这样我们就可以读取到这个style的属性。这是我们对这个实现过程的思考。

下面以我以前写的一个项目IconTabPageIndicator为例，全部代码见其develop分支。这是一个底部菜单指示器，其中每个tab（继承自TextView）的具体表现我们都希望能够在style中定义。所以首先我们先定义一个属性，用于指定这个tab的style：

    <attr name="tabView" format="reference"/>

下面分别说明对这个属性的两种使用方式。

在Java代码中获取

重写构造方法。在本例子中，我们的TabView是通过在java代码中自己new出来的，调用的是构造方法TabView(Context context)，所以我们需要重写这个构造方法，在这个构造方法中调用this(context, null, R.attr.tabView)，第三个参数传入的是R.attr.tabView，即我们定义的style属性。

        public TabView(Context context) {
            this(context, null, R.attr.tabView);
        }

然后我们重写所调用的这个带defStyle参数的构造方法，因为另外一个构造方法TextView(Context context, AttributeSet attrs)也是调用了它：

        public TabView(Context context, AttributeSet attr, int defStyle) {
            super(context, attr, defStyle);
            TypedArray a = context.obtainStyledAttributes(attr, R.styleable.TabView, defStyle, 0);
            iconWidth = a.getDimensionPixelSize(R.styleable.TabView_iconWidth, 0);
            iconHeight = a.getDimensionPixelSize(R.styleable.TabView_iconHeight, 0);
            a.recycle();
        }

在构造方法中，首先第一行是调用父构造方法。接下来，我们就需要获取我们自定义的其他属性了，比如在这个例子中的图标宽高，获取时调用的方法与昨天所使用的有点不同，我们调用的是

obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)，第三个参数是我们定义的style属性，第四个参数则是style资源。在确定一个属性最终的值的时候，优先级顺序是这样的：

首先获取给定的AttributeSet中的属性值
如果找不到，则去AttributeSet中style（你在写布局文件时定义的style="@style/xxxx"）指定的资源获取
如果找不到，则去defStyleAttr以及defStyleRes中的默认style中获取。
最后去找的是当前theme下的基础值。

所以在上面的方法中，我们也可以给第四个参数传一个我们默认的style（R.style.xxx），当使用者没有在第三个属性所指定的style中声明一些属性时，就会使用我们第四个参数中的style里的属性。

在调用obtainStyledAttributes方法获取到属性之后，后面如何使用则可参考前一篇博客，或本项目。

别人如何使用

理论上，其他人使用的时候，只要写一个style，然后在他的应用的主题中指定，就可以了。但是通常我们会需要指定许多属性的值，而这些属性的值大部分情况下都是通用的。所以我们首先应提供一个良好的style，如下：

    <style name="TabView">
        <item name="android:gravity">bottom|center_horizontal</item>
        <item name="android:layout_width">0dp</item>
        <item name="android:background">@android:color/white</item>
        <item name="android:layout_height">match_parent</item>
        <item name="android:textColor">@color/tab_text_selector</item>
        <item name="android:textSize">12sp</item>
        <item name="iconWidth">27dp</item>
        <item name="iconHeight">27dp</item>
        <item name="android:paddingTop">4dp</item>
        <item name="android:paddingBottom">4dp</item>
        <item name="android:drawablePadding">2dp</item>
    </style>

在这个style中，我定义了tab文字居中，背景色，字体大小颜色，边距等。在不重写其中的属性的情况下，就能提供一个外观良好的效果。

然后写个theme，在其中指定这个style，算是作为一个给其他开发者学习的示例：

    <style name="Theme.IndicatorDefault" parent="android:Theme">
        <item name="tabView">@style/TabView</item>
    </style>

这里的tabView就是我们所定义的style属性，也是我们在构造方法中指定的R.attr.tabView。

如果库的使用者需求对这style进行修改，只需要写一个style，继承自我们的TabViewstyle，重写里面的属性值即可：

    <style name="MyTabView" parent="TabView">
        <item name="iconWidth">28dp</item>
        <item name="iconHeight">28dp</item>
    </style>

当然，还有最重要的一步：必须在自己的项目的主题中指定：

    <style name="AppTheme" parent="Theme.AppCompat.Light">
        <item name="tabView">@style/MyTabView</item>
    </style>

此例子的完整项目请参考Github项目IconTabPageIndicator

在布局文件中指定style属性

我们定义的style属性，除了通过Java代码来获取使用之外，也可以直接通过布局文件来使用。需要使用到的是style属性。

我们对一个控件的style属性，通常的写法都是：style="@style/xxxxx"，或者是指定android系统中的属性：style="@android:style/xxxx"，除此之外，我们也可以用来指定我们所定义的style属性。

我另一个练习的项目ActionSheet就是使用了这种方式。完整代码请参见github上该项目地址，这里仅摘取部分相关的代码。

ActionSheet是我写的一个和qq菜单有点像的菜单，我希望菜单的每一项都是可以配置的。由于菜单是通过Dialog来加载，而Dialog是在Java代码中new出来，所以不能通过在xml中定义各个属性来完成菜单外观的配置，因此采用了这种方式。

首先同样是定义一些属性，和上面的一样：

    <attr name="ActionSheetList" format="reference"/>
    <attr name="ActionSheetCancel" format="reference"/>
    <attr name="ActionSheetItem" format="reference"/>

这里表示的是菜单列表的属性，取消按钮的样式，以及每一项菜单的样式。然后在我们的菜单布局文件中，除了不允许配置的属性我们进行了声明之外，其他的都是用style属性来指定，写法是style="?attr/你所定义的属性名"，如下：

    <ListView
        android:id="@+id/menu_items"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        style="?attr/ActionSheetList"
        android:listSelector="@android:color/transparent"/>

    <Button
        android:id="@+id/menu_cancel"
        style="?attr/ActionSheetCancel"/>

同样在我们的style.xml文件中，需要定义这几个style：

    <style name="ActionSheetList">
        <item name="android:divider">#c9dddddd</item>
        <item name="android:dividerHeight">1px</item>
    </style>
    下面代码略...

而库的使用者，在使用的时候，也需要指定这几个属性值：

    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="ActionSheetList">@style/ActionSheetList</item>
        <item name="ActionSheetItem">@style/ActionSheetItem</item>
        <item name="ActionSheetCancel">@style/ActionSheetCancel</item>
    </style>

本篇到此结束，相关项目如下：

IconPageIndicator 开发分支，学习自JakeWharton大神的ViewPagerIndicator
ActionSheet，学习自哪个项目我也忘了。

下篇讲一下如何在自定义控件中增加状态state。

本文原创，转载请注明在CSDN上的出处：http://blog.csdn.net/maosidiaoxian/article/details/50037371

码农公寓