Android -- 深入了解自定義屬性

1，相信我們寫過自定義控件的同學都會有一個疑問，自定義屬性到底是怎么工作的，為什么要使用自定義屬性呢，接下來結帶着大家一起來學習學習,在學習這一篇的時候，可以下看看我的上一篇《從源碼的角度一步步打造自己的TextView》，會對這篇有更好的理解

2，為什么要使用自定義屬性

　　我們要使用自定義屬性的話首先要我們有這個自定義屬性，那么我們常見的控件Textview的Android：text屬性是怎么來的呢，我們來一起看一下系統的自定義屬性源碼，系統定義的所有屬性我們可以在\sdk\platforms\Android-xx\data\res\values目錄下找到attrs.xml這個文件，這里只找幾個很常見的view屬性

<declare-styleable name="View">
    <attr name="id" format="reference" />
    <attr name="background" format="reference|color" />
    <attr name="padding" format="dimension" />
     ...
    <attr name="focusable" format="boolean" />
     ...
</declare-styleable>

<declare-styleable name="TextView">
    <attr name="text" format="string" localization="suggested" />
    <attr name="hint" format="string" />
    <attr name="textColor" />
    <attr name="textColorHighlight" />
    <attr name="textColorHint" />
     ...
</declare-styleable>

<declare-styleable name="ViewGroup_Layout">
    <attr name="layout_width" format="dimension">
        <enum name="fill_parent" value="-1" />
        <enum name="match_parent" value="-1" />
        <enum name="wrap_content" value="-2" />
    </attr>
    <attr name="layout_height" format="dimension">
        <enum name="fill_parent" value="-1" />
        <enum name="match_parent" value="-1" />
        <enum name="wrap_content" value="-2" />
    </attr>
</declare-styleable>

<declare-styleable name="LinearLayout_Layout">
    <attr name="layout_width" />
    <attr name="layout_height" />
    <attr name="layout_weight" format="float" />
    <attr name="layout_gravity" />
</declare-styleable>

<declare-styleable name="RelativeLayout_Layout">
    <attr name="layout_centerInParent" format="boolean" />
    <attr name="layout_centerHorizontal" format="boolean" />
    <attr name="layout_centerVertical" format="boolean" />
     ...
</declare-styleable>

　　首先我們知道我們所有的控件都是繼承自view這個類的，所以view類所擁有的屬性我們繼承它的子類是全部都擁有的，而我們父view類卻不能使用子view的特有的屬性，充分的體現了我們的語言的多態性。再看看我們上面的標簽，都有一個共同點，就是<declare-styleable name = "xxxx"> ，然后里面還有一堆的子標簽，而這些子標簽就表示這是這個XXX類的屬性。但是並不是每個控件都能使用所有屬性，LinearLayout中能使用layout_weight屬性，而RelativeLayout卻不能使用，因為layout_weight是為LinearLayout的LayoutParams定義的。

3，怎么自定義屬性

　　我們根據上面的源碼我們知道，這兩種的區別就是attr標簽后面帶不帶format屬性，如果帶format的就是在定義屬性，如果不帶format的就是在使用已有的屬性，name的值就是屬性的名字，format是限定當前定義的屬性能接受什么值。而系統定義的屬性一般引用都用android：XXX引用，如果我們現在要定義一個text屬性，所以我們可以有兩種定義我們的方式

　　常規方式：

<resources>
    <declare-styleable name="MyTextView">
        <attr name=“text" format="string" />
    </declare-styleable>
</resources>

　　引用系統已經定義好的：

<resources>
    <declare-styleable name="MyTextView">
        <attr name=“android:text"/>
    </declare-styleable>
</resources>

　　為什么這里我們還要引自系統屬性呢，因為我們的MyTextView是繼承的View，而android:text是TextView的特殊屬性，所以這里必須要引用一下。

3，屬性值的類型format

　　format一共支持11種類型

　　① reference

• 屬性定義：

<declare-styleable name = "名稱">
     <attr name = "background" format = "reference" />
</declare-styleable>

• 屬性使用：

<ImageView android:background = "@drawable/圖片ID"/>

　　② color

• 屬性定義：

<attr name = "textColor" format = "color" />

• 屬性使用：

<TextView android:textColor = "#00FF00" />

　　③boolean

• 屬性定義：

<attr name = "focusable" format = "boolean" />

• 屬性使用：

<Button android:focusable = "true"/>

　　④dimension

• 屬性定義：

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

• 屬性使用：

<Button android:layout_width = "42dip"/>

　　⑤float

• 屬性定義：

<attr name = "fromAlpha" format = "float" />

• 屬性使用：

<alpha android:fromAlpha = "1.0"/

　　⑥integer

• 屬性定義：

<attr name = "framesCount" format="integer" />

• 屬性使用：

<animated-rotate android:framesCount = "12"/>

　　⑦string

• 屬性定義：

<attr name = "text" format = "string" />

• 屬性使用：

<TextView android:text = "我是文本"/>

　　⑧fraction

• 屬性定義：

<attr name = "pivotX" format = "fraction" />

• 屬性使用：

<rotate android:pivotX = "200%"/>

　　⑨ enum：枚舉值

• 屬性定義：

<declare-styleable name="名稱">
    <attr name="orientation">
        <enum name="horizontal" value="0" />
        <enum name="vertical" value="1" />
    </attr>
</declare-styleable>

• 屬性使用：

<LinearLayout  
    android:orientation = "vertical">
</LinearLayout>

　　注意：當使用枚舉屬性的話不能在一個屬性中同時使用兩個值

　　⑩ flag：位或運算

• 屬性定義：

<declare-styleable name="名稱">
    <attr name="gravity">
            <flag name="top" value="0x30" />
            <flag name="bottom" value="0x50" />
            <flag name="left" value="0x03" />
            <flag name="right" value="0x05" />
            <flag name="center_vertical" value="0x10" />
            ...
    </attr>
</declare-styleable>

• 屬性使用：

<TextView android:gravity="bottom|left"/>

　　位運算符在使用的時候可以使用多個屬性

　　⑪混合類型：屬性定義時可以指定多種類型值

• 屬性定義：

<declare-styleable name = "名稱">
     <attr name = "background" format = "reference|color" />
</declare-styleable>

• 屬性使用：

<ImageView
android:background = "@drawable/圖片ID" />
或者：
<ImageView
android:background = "#00FF00" />

　　以上就是所有的自定義屬性的格式了，知道了這些，以后方便我們更准確的去定義自己的屬性

4，在類中獲取對應的自定義屬性

　　首先在attrs文件中添加我們的自定義屬性

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="MyTextView2">
        <attr name="myText" format="string"/>
        <attr name="myTextColor" format="color"/>
        <attr name="myTextSize" format="dimension"/>
    </declare-styleable>
</resources>

　　然后我們在布局文件中添加我們的自定義屬性，這里要注意一下要引入我們的自定義空間，一般來說有兩種：xmlns:mytextview="http://schemas.android.com/apk/res-auto”，res-auto表示自動查找，還有一種寫法xmlns:mytextview="http://schemas.android.com/apk/com.example.myview"，com.example.myview 為我們的應用程序包名。

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

    <com.qianmo.activitydetail.MyTextView2
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="#00ff00"
        myview:myText=" I Love You ......I Love You ......"
        myview:myTextColor="#ff3399"
        myview:myTextSize="25sp"
        />

</LinearLayout>

　　在構造方法中獲取我們的自定義屬性

 public MyTextView2(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init(context, attrs, defStyleAttr);
    }

    /**
     * 初始化數據
     */
    private void init(Context context, AttributeSet attrs, int defStyleAttr) {
        //獲取自定義屬性的值
        TypedArray a = context.getTheme().obtainStyledAttributes(attrs, R.styleable.MyTextView2, defStyleAttr, 0);
        mText = a.getString(R.styleable.MyTextView2_myText);
        mTextColor = a.getColor(R.styleable.MyTextView2_myTextColor, Color.BLACK);
        mTextSize = a.getDimension(R.styleable.MyTextView2_myTextSize, 30f);
        a.recycle();

        //初始化Paint數據
        mPaint = new Paint();
        mPaint.setColor(mTextColor);
        mPaint.setTextSize(mTextSize);

        //獲取繪制的寬高
        mBound = new Rect();
        mPaint.getTextBounds(mText, 0, mText.length(), mBound);
        Log.i(TAG, "mText :" + mText + ",mTextColor:" + mTextColor+ ",mTextSize:" + mTextSize);
    }

　　打印結果如下：

mText : I Love You ......I Love You ......,mTextColor:-52327,mTextSize:65.625

　　ok，這樣我們的就本上使用上了自定義屬性，但是在使用的時候我們發現了兩個陌生的類AttributeSet和TypeArray類，下面讓我們來了解了解吧

5，AttributeSet和TypeArray的了解

　　Attributeset看名字就知道是一個屬性的集合，實際上，它內部就是一個XML解析器，幫我們將布局文件中該控件的所有屬性解析出來，並以key-value的兼職對形式維護起來。其實我們完全可以只用他通過下面的代碼來獲取我們的屬性就行。

//打印AttributeSet中的值
        for (int i = 0; i < attrs.getAttributeCount(); i++) {
            Log.i(TAG, "name:" + attrs.getAttributeName(i) + ",value:" + attrs.getAttributeValue(i));
        }

　　看看我們打印出來的結果

03-21 03:24:44.339 12206-12206/com.qianmo.activitydetail I/MyTextView: getWidth():1080,getHeight(): 1731
03-21 03:30:59.950 17617-17617/com.qianmo.activitydetail I/MyTextView: name:background,value:#ff00ff00
03-21 03:30:59.950 17617-17617/com.qianmo.activitydetail I/MyTextView: name:layout_width,value:-1
03-21 03:30:59.950 17617-17617/com.qianmo.activitydetail I/MyTextView: name:layout_height,value:-1
03-21 03:30:59.950 17617-17617/com.qianmo.activitydetail I/MyTextView: name:myText,value: I Love You ......I Love You ......
03-21 03:30:59.950 17617-17617/com.qianmo.activitydetail I/MyTextView: name:myTextColor,value:#ffff3399
03-21 03:30:59.950 17617-17617/com.qianmo.activitydetail I/MyTextView: name:myTextSize,value:25.0sp

　　可以看到使用Attributeset得到的屬性的值是取到的xml文件中的值，而我們想要的textsize的大小，還得想方法將sp去掉才能拿到我們的25.0，這時候我們就需要一個人幫我們來這樣做了，而typeArray就順勢而生了，我們來看看使用TypeArray得到的數據

 TypedArray a = context.getTheme().obtainStyledAttributes(attrs, R.styleable.MyTextView2, defStyleAttr, 0);
        mText = a.getString(R.styleable.MyTextView2_myText);
        mTextColor = a.getColor(R.styleable.MyTextView2_myTextColor, Color.BLACK);
        mTextSize = a.getDimension(R.styleable.MyTextView2_myTextSize, 30f);
        a.recycle();
Log.i(TAG, "mText :" + mText + ",mTextColor:" + mTextColor + ",mTextSize:" + mTextSize);

　　打印的結果

mText : I Love You ......I Love You ......,mTextColor:-52327,mTextSize:65.625

　　這樣的數據就是我們想要的了，這樣我們就了解的差不多了，See You Next Time !