Android中自訂屬性的使用

做Android布局是件很享受的事，這得益於他良好的xml方式。使用xml可以快速有效為軟體定義程式介面。可是有時候我們總感覺官方定義的一些基本組件不夠用，自訂群組件就不可避免了。那麼如何才能做到像官方提供的那些組件一樣用xml來定義他的屬性呢？現在我們就來討論一下他的用法。

一、在res/values檔案下定義一個attrs.xml檔案，代碼如下：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="ToolBar">
        <attr name="buttonNum" format="integer"/>
        <attr name="itemBackground" format="reference|color"/>
    </declare-styleable>
</resources>

二、在布局xml中如下使用該屬性:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:toolbar="http://schemas.android.com/apk/res/cn.zzm.toolbar"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <cn.zzm.toolbar.ToolBar android:id="@+id/gridview_toolbar"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:background="@drawable/control_bar"
        android:gravity="center"
        toolbar:buttonNum="5"
        toolbar:itemBackground="@drawable/control_bar_item_bg"/>
</RelativeLayout>

三、在自訂群組件中，可以如下獲得xml中定義的值：

TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.ToolBar);
buttonNum = a.getInt(R.styleable.ToolBar_buttonNum, 5);
itemBg = a.getResourceId(R.styleable.ToolBar_itemBackground, -1);

a.recycle();

就這麼簡單的三步，即可完成對自訂屬性的使用。

*********************************************************************

好了，基本用法已經講完了，現在來看看一些注意點和知識點吧。

首先來看看attrs.xml檔案。

該檔案是定義屬性名稱和格式的地方，需要用<declare-styleable name="ToolBar"></declare-styleable>包圍所有屬性。其中name為該屬性集的名字，主要用途是標識該屬性集。那在什麼地方會用到呢？主要是在第三步。看到沒？在擷取某屬性標識時，用到"R.styleable.ToolBar_buttonNum"，很顯然，他在每個屬性前面都加了"ToolBar_"。

在來看看各種屬性都有些什麼類型吧：string , integer , dimension , reference , color , enum.

前面幾種的聲明方式都是一致的，例如：<attr name="buttonNum" format="integer"/>。
只有enum是不同的，用法舉例：

<attr name="testEnum">
    <enum name="fill_parent" value="-1"/>
    <enum name="wrap_content" value="-2"/>
</attr>

如果該屬性可同時傳兩種不同的屬性，則可以用“|”分割開即可。

 

讓我們再來看看布局xml中需要注意的事項。

首先得聲明一下：xmlns:toolbar=http://schemas.android.com/apk/res/cn.zzm.toolbar
注意，“toolbar”可以換成其他的任何名字，後面的url地址必須最後一部分必須用上自訂群組件的包名。自訂屬性了，在屬性名稱前加上“toolbar”即可。

 

最後來看看java代碼中的注意事項。

在自訂群組件的建構函式中，用

TypedArray a = context.obtainStyledAttributes(attrs,R.styleable.ToolBar);

來獲得對屬性集的引用，然後就可以用“a”的各種方法來擷取相應的屬性值了。這裡需要注意的是，如果使用的方法和擷取值的類型不對的話，則會返回預設值。因此，如果一個屬性是帶兩個及以上不用類型的屬性，需要做多次判斷，知道讀取完畢後才能判斷應該賦予何值。當然，在取完值的時候別忘了回收資源哦！