原文:A deep dive into Android View constructors
我经常看到关于Android View构造方法的困惑。为什么有四个构造方法?每个参数是做什么的?我需要实现哪个构造方法?
概述
如果你想要一个直接而实际的建议,这里有几个不错的指导原则:
- 在代码中创建View的时候用View(Context)
- 当从XML inflate view的时候重写View(Context, AttributeSet)。
对于那些仍和我一样想继续探究的人-让我们深入下去吧。
构造方法参数
构造函数参数最多有四个。简单总结下:
- Context - View中随处都会用到。
- AttributeSet - XML属性(当从XML inflate的时候)。
- int defStyleAttr - 应用到View的默认风格(定义在主题中)。
- int defStyleResource - 如果没有使用defStyleAttr,应用到View的默认风格
除了Context,其它的参数只是用来通过XML属性配置View的初始状态(从布局,style以及theme中)。
属性
让我们从如何定义XML属性的开始讨论。这里是一个XML中最基本的ImageView:
<ImageView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:src="@drawable/icon"
/>
你有没有想过这里的layout_width, layout_height 以及 src是从哪里来的?它们可不是凭空产生的;实际上是通过把这些属性明确的声明为系统需要处理的东西。比如,src就是在这里定义的:
<declare-styleable name="ImageView">
<!-- Sets a drawable as the content of this ImageView. -->
<attr name="src" format="reference|color" />
</declare-styleable>
事实上这跟Custom View添加自定义属性是一样的,所有的resources文件中声明的属性都会在R.attr类中生成对应的成员变量:
public final class R {
public static final class attr {
public static final int src=0x7f010038;
...
}
}
但是声明在标签中的属性,系统还会在R.styleable类中生成相关的成员变量:
public static final class styleable {
public static final int[] ImageView = {
0x7f010038...
};
public static final int ImageView_src = 0;
...
}
每个declare-styleable产生一个R.styleable.[name],外加每个属性的R.styleable.[name]_[attribute] 。比如,上面的代码产生R.styleable.ImageView和R.styleable.ImageView_src。
这些资源是什么东西呢?R.styleable.[name]是所有属性资源的数组,系统使用它来查找属性值。每个R.styleable.[name]_[attribute]只不过是这个数组的索引罢了,所以你可以一次性取出所有属性,然后分别查询每个的值。
如果你把它想象成一个cursor,R.styleable.[name]就可以看成是一个待查找的column列表,而R.styleable.[name]_[attribute]就是一个column的索引。
AttributeSet
上面写的XML是以一个AttributeSet的形式传递给View的。
通常你不直接使用AttributeSet。而是使用Theme.obtainStyledAttributes()
。这是因为原始的属性通常需要引用和应用样式。比如,如果你在XML中定义了style=@style/MyStyle,这个方法先获取MyStyle,然后把它的属性混合进去。最终obtainStyledAttributes() 返回一个TypedArray,你可以用它来获取属性值。
这个过程简化之后就像这样:
public ImageView(Context context, AttributeSet attrs) {
TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.ImageView, 0, 0);
Drawable src = ta.getDrawable(R.styleable.ImageView_src);
setImageDrawable(src);
ta.recycle();
}
这里我们向obtainStyledAttributes()传递了两个参数。第一个参数是AttributeSet attrs,即XML中的属性,表示从layout文件中直接为这个View添加的属性的集合(一种是直接使用android:layout_width=“wrap_content"这种直接指定,还有一种是通过style=”@style/somestyle"指定。)。第二个参数是R.styleable.ImageView数组,它告诉这个方法我们想取哪个属性的值,这里表示要获取ImageView属性的值。
当获得了TypedArray之后,我们就可以获取单个属性了。我们需要使用 R.styleable.ImageView_src来正确索引数组中的属性。
通常我们可以一次获取多个属性。实际上,真实ImageView的实现要比上面的复杂多了。
Theme 属性
AttributeSet并不是obtainStyledAttributes() 获取属性值的唯一地方。属性也可以存在于主题中。但是它在View inflate的过程中扮演着不重要的角色,因为主题一般不会设置src这样的属性。但是如果你使用obtainStyledAttributes() 获取主题属性的话它就有作用了
Default Style Attribute
你可能注意到了obtainStyledAttributes()的最后两个参数我使用的值为0。实际上它们是两个资源引用-defStyleAttr 和 defStyleRes。这里我将关注的是第一个。
defStyleAttr是obtainStyledAttributes()最令人困惑的参数。根据官网:
当前主题中包含了为TypedArray提供默认值的样式资源的引用的一个属性。
用普通的语言表述,其实它就是一个为某个类型的View定义一个基本样式的方法。比如,如果你想一次性修改app中所有TextView,你可以在主题中设置textViewStyle。如果不存在这个东西的话,你就需要手动为每个TextView定义样式了。
让我们介绍一下它实际是如何工作的,以TextView为例。
首先,他是一个属性(这里是,R.attr.textViewStyle
)。这里是安卓系统定义textViewStyle的地方:
<resources>
<declare-styleable name="Theme">
<!-- ...snip... -->
<!-- Default TextView style. -->
<attr name="textViewStyle" format="reference" />
<!-- ...etc... -->
</declare-styleable>
</resource>
我们使用了declare-styleable,但是这次是用来定义存在于theme中的属性。这里我们说textViewStyle是一个reference- 即,它的值只是一个资源的引用,这里,它应该是一个指向style的引用。
接下来,我们必须在当前主题设置textViewStyle。默认的Android主题如下:
<resources>
<style name="Theme">
<!-- ...snip... -->
<item name="textViewStyle">@style/Widget.TextView</item>
<!-- ...etc... -->
</style>
</resource>
然后需要为Application或者Activity设置这个主题,通常是通过manifest设置:
<activity
android:name=".MyActivity"
android:theme="@style/Theme"
/>
现在我们就可以在obtainStyledAttributes()里使用它了:
TypedArray ta = context.getTheme().obtainStyledAttributes(attrs, R.styleable.TextView, R.attr.textViewStyle, 0);
最终的效果是,任何没有在AttributeSet中定义的属性都将用textViewStyle引用的样式填充。
除非你在写核心源码,否则你并不需要知道这些实现的细节。它的存在主要是Android framework为了让你可以在主题里为不同的View定义基础样式。
Default Style Resource
defStyleRes就要比defStyleAttr简单多了。它只是一个style资源(@style/Widget.TextView)。不需要间接的通过theme。
只有在defStyleAttris没有定义的情况下,才会应用style中的defStyleRes(设置为0,或者没有在主题中设置)。
优先级
我们现在有了一些列通过obtainStyledAttributes()获取属性值的方式。这里是它们的优先级,从高到低:
- 定义在AttributeSet中的值
- 定义在AttributeSet中的style资源(比如:style=@style/blah)
- defStyleAttr指定的默认样式。
- defStyleResource指定的默认样式资源(如果没有defStyleAttr)
- 主题中的值
换句话说,任何直接在XML中设置的属性都将首先被使用。但是如果你没有设置,这些属性也可以从其它地方获取。
总结
本文不是应该讨论View的构造函数的吗?
总共有四个构造函数,依次增加一个参数:
View(Context)
View(Context, AttributeSet)
View(Context, AttributeSet, defStyleAttr)
View(Context, AttributeSet, defStyleAttr, defStyleRes)
一般来说,你只需实现前两个(一个用于代码,一个用于XML inflation)。
我一般这样设置我的自定义View:
SomeView(Context context) {
this(context, null);
}
SomeView(Context context, AttributeSet attrs) {
// Call super() so that the View sets itself up properly
super(context, attrs);
// ...Setup View and handle all attributes here...
}
只需要这个两个参数的构造方法你就能随意的使用obtainStyledAttributes()了。实现默认样式的一个简便方法是直接提供defStyleRes给它。那样你就不需要忍受defStyleAttr的痛苦了(其实它更多时候是一个framework工具,app中通常不需要)。