我们自定义控件的时候,最常见的需要重写构造函数是 public View(Context context) {}
和 public View(Context context, @Nullable AttributeSet attrs) {}
, 因为第一个是在 Java 代码中创建 View 时会调用,第二是在 XML 布局文件中引用 View 时,会被调用。这两个构造函数都是系统会调用的方法。但是,还剩两个构造函数`` public View(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {}和
public View(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) {}`, 是需要我们自行调用的,系统并不会调用,当我们需要为自定义 View 设置默认的属性的时候,就需要用到了。
这是一段典型的一段自定义 View 的构造函数。
public class AttrTestTextView extends TextView {
public AttrTestTextView(Context context) {
super(context);
}
public AttrTestTextView(Context context, AttributeSet attrs) {
this(context, attrs, R.attr.defaultStyleAttr);
}
public AttrTestTextView(Context context, AttributeSet attrs, int defStyleAttr) {
this(context, attrs, defStyleAttr, R.style.DefaultStyleRes);
}
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
public AttrTestTextView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
super(context, attrs, defStyleAttr, defStyleRes);
TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.AttrTestTextView,
defStyleAttr, defStyleRes);
...
typedArray.recycle();
}
}
可以看出来,属性的获取主要由 context.obtainStyledAttributes
决定,而最后两个参数defStyleAttr
和defStyleRes
决定了最终默认的属性样式是怎么的。
为了弄清楚默认样式的运作规律,我们先为这个自定义 View 创建 5 个自定义属性,和一个单独的属性,attrs.xml
文件如下:
<resources>
<declare-styleable name="AttrTestTextView">
<attr name="firstAttr" format="string" />
<attr name="secondAttr" format="string" />
<attr name="thirdAttr" format="string" />
<attr name="fourthAttr" format="string" />
<attr name="fifthAttr" format="string" />
</declare-styleable>
<attr name="defaultStyleAttr" format="reference" />
</resources
设置 5
个属性的原因是 Android 的 View 属性覆盖的优先级有 5
处,分别是:
- 布局文件中的直接指定的属性
- 布局文件中的 style 中指定的属性
- 我们自己定义的 Style
- Theme 中直接指定的 Style 引用
- Theme 中直接指定的属性
他们之间的覆盖的优先级是:
1 > 2 > 3 / 4 > 5
为了验证我们的结论,首先在Application 或 Activity 的 Theme 中直接设置这5个属性,并且为上方定义的 defaultStyleAttr
属性设置一个style的引用,值为下方定义的 @style/DefaultStyleInAppTheme
, 而这个属性将作为自定义View构造函数中的第三个值,即该自定义 View 默认的 style。DefaultStyleRes
则作为自定义 View 的构造函数中的第四个参数,而 LayoutStyle
则在布局中直接引用, styles.xml
文件如下:
<resources>
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<item name="firstAttr">firstAttr from theme attr</item>
<item name="secondAttr">secondAttr from theme attr</item>
<item name="thirdAttr">thirdAttr from theme attr</item>
<item name="fourthAttr">fourthAttr from theme attr</item>
<item name="fifthAttr">fifthAttr from theme attr</item>
<item name="defaultStyleAttr">@style/DefaultStyleInAppTheme</item>
</style>
<style name="DefaultStyleInAppTheme">
<item name="firstAttr">firstAttr from theme style</item>
<item name="secondAttr">secondAttr from theme style</item>
<item name="thirdAttr">thirdAttr from theme style</item>
</style>
<style name="DefaultStyleRes">
<item name="firstAttr">firstAttr from style res</item>
<item name="secondAttr">secondAttr from style res</item>
<item name="thirdAttr">thirdAttr from style res</item>
<item name="fourthAttr">fourthAttr from style res</item>
</style>
<style name="LayoutStyle">
<item name="firstAttr">firstAttr from layout style</item>
<item name="secondAttr">secondAttr from layout style</item>
</style>
</resources
然后我们自定义一个 TextView, 分别获取这 5 个属性的值,并且显示出来。
public class AttrTestTextView extends TextView {
public AttrTestTextView(Context context) {
super(context);
}
public AttrTestTextView(Context context, AttributeSet attrs) {
this(context, attrs, R.attr.defaultStyleAttr);
}
public AttrTestTextView(Context context, AttributeSet attrs, int defStyleAttr) {
this(context, attrs, defStyleAttr, R.style.DefaultStyleRes);
}
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
public AttrTestTextView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
super(context, attrs, defStyleAttr, defStyleRes);
TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.AttrTestTextView,
defStyleAttr, defStyleRes);
StringBuilder sb = new StringBuilder();
sb.append(typedArray.getString(R.styleable.AttrTestTextView_firstAttr)).append("\n");
sb.append(typedArray.getString(R.styleable.AttrTestTextView_secondAttr)).append("\n");
sb.append(typedArray.getString(R.styleable.AttrTestTextView_thirdAttr)).append("\n");
sb.append(typedArray.getString(R.styleable.AttrTestTextView_fourthAttr)).append("\n");
sb.append(typedArray.getString(R.styleable.AttrTestTextView_fifthAttr));
setText(sb);
typedArray.recycle();
}
}
我们知道,属性的获取最终是根据 obtainStyledAttributes()
方法获得,他的最后两个参数也就是构造行数的最后两个参数,这两个参数都是设置自定义 View 的默认样式,那么,他们作用的优先级是怎样的?
* @param defStyleRes A resource identifier of a style resource that
* supplies default values for the view, used only if
* defStyleAttr is 0 or can not be found in the theme. Can be 0
* to not look for defaults.
根据 API 文档的可以看出,当 defStyleAttr
参数被设置为 0
, 或者在 Application 和 Activity 的 Theme 中找不到 defStyleAttr
属性的赋值(例如 styles.xml 中的 <item name="defaultStyleAttr">@style/DefaultStyleInAppTheme</item>
这行代码被删除),那么,这个 View 的默认样式就是 defStyleRes
参数所引用的属性样式。可以看出这两个参数是冲突的,而且冲突级别是整个 style, 即 defStyleAttr
参数的 style 能找到情况下就忽略了整个 defStyleRes
的属性集。
然后,在布局文件中添加自定义的 View,分别设置了直接的属性,firstAttr
和 设置了 styles.xml
中定义的 style。
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.ryeeeeee.attrtest.AttrTestTextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:firstAttr="firstAttr from layout attr"
style="@style/LayoutStyle"/>
</RelativeLayout>
运行结果如下图,可以看到 defStyleRes
所引用的 style 中的属性完全被忽略了,因为 styles.xml
中能找到 defStyleAttr
这个属性的赋值:
现在将 styles.xml
中能找到 defStyleAttr
这个属性的赋值删除,或者将 defStyleAttr
参数使用 0
赋值, 运行结果如下,可以看到 defStyleRes
所引用的style 才显示出来:
实验结果证明,属性层级的覆盖优先级是 1 > 2 > 3 / 4 > 5
,和上方结论一致。需要注意的是,在 style 层级的优先级 defStyleAttr
参数所引用的 style 的优先级是高于 defStyleRes
的。