自定义进阶1——自定义属性剖析

上一节已经说了自定义属性的用法,实现步骤有如下几步:
  1. 自定义一个CustomView(extends View )类
  2. 编写values/attrs.xml,在其中编写declare-styleable和attr等标签元素
  3. 在布局文件中CustomView使用自定义的属性(注意添加自己的namespace)
  4. 在CustomView的构造方法中通过TypedArray获取自定义属性

知道了这些,我们完全可以写自己的view了,但为什么要这样呢?它是如何运行的呢?正所谓知其然,更要知其所以然,看了鸿洋大神的文章,真是有种醍醐灌顶的感觉啊
好了,不拍马屁了,切入正题

首先,写一个自定义属性文件

<resources>

    <!-- declare-styleable的 name是可以随便取名字的 -->
    <declare-styleable name="CustomAttrView">
        <attr name="text" format="string" />
    </declare-styleable>

</resources>

编写自定义view

public class CustomAttrView extends View {

    String TAG = "tag";
    Paint paint;
    String text;

    public CustomAttrView(Context context) {
        this(context, null);
    }

    public CustomAttrView(Context context, AttributeSet attrs) {
        super(context, attrs);
        paint = new Paint();
        TypedArray typedArray = context.obtainStyledAttributes(attrs,
                R.styleable.CustomAttrView);

        text = typedArray.getString(R.styleable.CustomAttrView_text);
        Log.i(TAG, "--text = " + text);
        typedArray.recycle();
    }

    @Override
    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
    }

    @Override
    protected void onDraw(Canvas canvas) {
        paint.setTextSize(80);
        canvas.drawText(text, 80f, 80f, paint);
    }
}

在activity_main.xml文件中引用
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:custom="http://schemas.android.com/apk/res/com.example.activity"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <com.example.activity.view.CustomAttrView
        android:layout_width="200dp"
        android:layout_height="100dp"
        custom:text="520" />

</RelativeLayout>

运行后输出的log日志为:



继续看代码,构造函数里有一个AttributeSet (参数集),具体的用途是什么?
修改下CustomAttrView

public CustomAttrView(Context context, AttributeSet attrs) {
        super(context, attrs);
        paint = new Paint();
        TypedArray typedArray = context.obtainStyledAttributes(attrs,
                R.styleable.CustomAttrView);

        text = typedArray.getString(R.styleable.CustomAttrView_text);
        Log.i(TAG, "--text = " + text);

        typedArray.recycle();

        int count = attrs.getAttributeCount();
        for (int i = 0; i < count; i++) {
            String attrName = attrs.getAttributeName(i);
            String attrVal = attrs.getAttributeValue(i);
            Log.i(TAG, "--attrName = " + attrName + " , attrVal = " + attrVal);
        }
    }
看下log输出

可以看出,AttributeSet保存的是该View声明的所有的属性,通过AttributeSet可以获得布局文件中定义的所有属性的key和value(还有一些方法,根据提示可以用下)
对比两次log,好像TypedArray并没有什么用,想要获得我自定义的text属性直接用AttributeSet也可以,好,修改下activity_main.xml

   <com.example.activity.view.CustomAttrView
        android:layout_width="@dimen/dp200"
        android:layout_height="@dimen/dp100"
        custom:text="@string/hello_world" />
再次运行,看下log
自定义进阶1——自定义属性剖析_第1张图片

通过AttributeSet获取的值,如果是引用都变成了@+数字的字符串。而使用TypedArray获取的值没有变化。TypedArray的作用现在明白了——TypedArray其实是用来简化我们的工作的,比如上例,如果布局中的属性的值是引用类型(比如:@dimen/dp100),如果使用AttributeSet去获得最终的像素值,那么需要先拿到id,然后再去解析id。而TypedArray正是帮我们简化了这个过程

捎带一下通过AttributeSet获取最终的像素值的过程:

int widthDimensionId =  attrs.getAttributeResourceValue(0, -1);
        Log.e(TAG, "layout_width= "+getResources().getDimension(widthDimensionId));

我的自定义属性文件只写了一个custom:text,很多情况下自定义属性的含义在android系统中已经有了明确的定义,比如我这个,那么直接使用android:text是否可以?

修改下attrs.xml

 <declare-styleable name="CustomAttrView">
        <attr name="android:text" />
    </declare-styleable>

因为我们使用的是已经定义好的属性,所以不需要去添加format属性(声明和使用的区别就是有没有format)。 
然后在类中这么获取:typedArray.getString(R.styleable.CustomAttrView_android_text);

布局文件中直接android:text="@string/hello_world"即可。

系统中定义的属性,其实和我们自定义属性的方式类似,你可以在sdk/platforms/android-xx/data/res/values该目录下看到系统中定义的属性。然后你可以在系统提供的View(eg:TextView)的构造方法中发现TypedArray获取属性的代码(自己去看一下)。

既然declare-styleable这个标签的name都能随便写,那么考虑问题:

styleable 的含义是什么?可以不写嘛?我自定义属性,我声明属性就好了,为什么一定要写个styleable呢?

其实的确是可以不写的,怎么做呢?


首先删除declare-styleable的标签

atrrs.xml变为
<?xml version="1.0" encoding="utf-8"?>
<resources> 
<attr name="text" format="string" />
</resources>

  
  
  
  
CustomAttrView.java如下

public class CustomAttrView extends View {

    String TAG = "tag";
    Paint paint;
    String text;
    private static final int[] mAttr = { R.attr.text };
    private static final int ATTR_ANDROID_TEXT = 0;

    public CustomAttrView(Context context) {
        this(context, null);
    }

    public CustomAttrView(Context context, AttributeSet attrs) {
        super(context, attrs);
        paint = new Paint();
        TypedArray typedArray = context.obtainStyledAttributes(attrs, mAttr);

        text = typedArray.getString(ATTR_ANDROID_TEXT);
        Log.i(TAG, "--text = " + text);

        typedArray.recycle();

    }

}
对比下两个构造函数,可以看到我们声明了一个int数组,数组中的元素就是我们想要获取的attr的id。并且我们根据元素的在数组中的位置,定义了一些整形的常量代表其下标,然后通过TypedArray进行获取。
还有如下区别:
R.styleable.CustomAttrView ——> mAttr
R.styleable.CustomAttrView_text——> ATTR_ANDROID_TEXT(0)

其实android在其内部也会这么做,按照传统的写法,它会在R.java生成如下代码:
   
   
   
   
public static final class attr {
      
        public static final int text = 0x7f010000;
    }
   
   
   
   
public static final class styleable {
 public static final int[] CustomAttrView = {
            0x7f010000
        };
    public static final int CustomAttrView_text = 0;
    };
}
styleale的的作用就是使系统可以完成很多常量(int[]数组,下标常量等)的编写,简化我们的开发工作。那么大家肯定还知道declare-styleable的name属性, 一般情况下写的都是我们自定义View的类名。主要为了直观的表达,该declare-styleable的属性,都是改View所用的。
套用下鸿洋大神的总结:
  • attrs.xml里面的declare-styleable以及item,android会根据其在R.java中生成一些常量方便我们使用(aapt干的),本质上,我们可以不声明declare-styleable仅仅声明所需的属性即可。
  • 我们在View的构造方法中,可以通过AttributeSet去获得自定义属性的值,但是比较麻烦,而TypedArray可以很方便的去获取。
  • 我们在自定义View的时候,可以使用系统已经定义的属性。


源代码


参考:

http://blog.csdn.net/lmj623565791/article/details/45022631

你可能感兴趣的:(Android开发,自定义,属性)