View构造方法详解及obtainStyledAttributes参数解析

构造方法

View的构造方法有如下几个,其中前三个方法是API 1即引入,这也是最常使用的构造方法。但是 View(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)是API 21才引入,使用时需要注意兼容性问题。

/**
  * Code中创建View时使用的构造方法
  * Simple constructor to use when creating a view from code.
  */
View(Context context)

/**
  * 绘制Xml中View时使用的构造方法
  * Constructor that is called when inflating a view from XML.
  */
View(Context context,AttributeSet attrs)

/**
  * Perform inflation from XML and apply a class-specific base style from a theme attribute.
  */
View(Context context, AttributeSet attrs, int defStyleAttr)


/**
  * Perform inflation from XML and apply a class-specific base style from a theme attribute or style resource.
  */
 View(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

View(Context context, AttributeSet attrs, int defStyleAttr)

日常开发中,使用较多的是前两种构造方法,相信开发者们一定比较熟悉。今天重点要介绍的是第三种构造方法View(Context context, AttributeSet attrs, int defStyleAttr)中的第三个参数defStyleAttr。

参考官方文档的参数详解如下,乍一看无法理解defStyleAttr和defStyleRes的含义,只能看到二者的作用是为View提供一些属性的默认值。

参数详解:
context Context: The Context the view is running in, through which it can access the current theme, resources, etc.
attrs AttributeSet: The attributes of the XML tag that is inflating the view.This value may be null.
defStyleAttr int: An attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.
defStyleRes int: 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.

参考View的实现源码,上述几个参数的作用是传递给context.obtainStyledAttributes来获取TypedArray,进而解析出Attribute。后续开始关键参数的介绍:

public View(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) {
        this(context);

        final TypedArray a = context.obtainStyledAttributes(
                attrs, com.android.internal.R.styleable.View, defStyleAttr, defStyleRes);

        <!-- ...snipped for brevity... -->
}
AttributeSet参数

首先来理解XML中Attributes的定义,以ImageView为例:

<ImageView
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:src="@drawable/icon"
  />

上述XML定义中的layout_width,layout_height和src就组成了AttributeSet对象,但是这些attribute定义是来自于哪里呢?其实系统在attrs.xml中通过<declare-styleable>声明了这些attributes。源码定义如下:

<declare-styleable name="ImageView">
  <!-- Sets a drawable as the content of this ImageView. -->
  <attr name="src" format="reference|color" />

  <!-- ...snipped for brevity... -->

</declare-styleable>

系统针对<declare-styleable>定义在R.java中生成了R.styleable.[name]数组,并对内每个attribute定义了一个R.styleable.[name]_[attribute]常量。上述例子生成的就是R.styleable.ImageView和R.styleable.ImageView_src。

其中R.styleable.[name]是所有attribute资源的数组,通过R.styleable.[name]_[attribute]作为数组的下标来查找指定资源。
在自定义View构造时,开发者经常通过AttributeSet(XML中定义的attributes)+R.styleable.[name](标志哪些attributes需要提取和attribute的排序)可解析后获取TypedArray对象。这是因为AttributeSet直接解析复杂度较大,系统才提供Theme.obtainStyledAttributes获取TypedArray以访问属性。

简单理解,上面的src的处理过程类似下面代码,当然实际源码复杂的多。

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();
}
defStyleAttr参数

开发者除了在XML中直接设置View的属性值,eg以上章节中ImageView的src,还可以通过theme来设置属性值。

An attribute in the current theme that contains a reference to a style resource that supplies defaults values for the TypedArray.

再来看一次defStyleAttr的文档说明,书读百遍,其义自现。这次以TextView为例来进行展示。

public TextView(Context context, @Nullable AttributeSet attrs) {
        this(context, attrs, com.android.internal.R.attr.textViewStyle);
    }

参考TextView的构造方法,defStyleAttr入参使用了R.attr.textViewStyle。在系统源码的attrs.xml中找到textViewStyle的定义:

<resources>
  <declare-styleable name="Theme">

    <!-- ...snip... -->

    <!-- Default TextView style. -->
    <attr name="textViewStyle" format="reference" />

    <!-- ...etc... -->

  </declare-styleable>
</resource>

我们使用declare-styleable来定义theme中可使用的attributes。这里指出textViewStyle是一个reference(对资源的引用),在这里应该是对style的引用。

查看源码中的themes.xml中Android的默认主题。开发者可通过对Application或Activity设置theme来使之生效。

<resources>
  <style name="Theme">

    <!-- ...snip... -->

    <item name="textViewStyle">@style/Widget.TextView</item>

    <!-- ...etc... -->

  </style>
</resource>

上述textViewStyle指向的Widget.TextView定义在styles.xml中,有兴趣的同学可以自行查看。

也是通过类似TextView的方法,Android系统为很多原生控件提供了默认属性值。相信大家也可以理解,defStyleAttr参数是当前theme下定义的一个style资源的属性,并为最后生成的TypedArray资源数组提供了默认值的功能。

最后一个参数defStyleRes相对简单一些,是一个style资源的引用来为View提供属性默认值。但是优先级较低。

obtainStyledAttibutes方法中几个参数的优先级如下:

  • 1、 Any value defined in the AttributeSet.
  • 2、The style resource defined in the AttributeSet (i.e. style=@style/blah).
  • 3、The default style attribute specified by defStyleAttr.
  • 4、The default style resource specified by defStyleResource (if there was no defStyleAttr).
  • 5、Values in the theme.

自定义View构造方法实现

在编写自定义View时,一般需要实现至少前两个构造方法。但是如果需要实现所有构造方法,注意不要使用this(...)进行级联调用。推荐的使用方法如下:

public MyView(Context context) {
    super(context);
    init(context, null, 0);
}

public MyView(Context context, AttributeSet attrs) {
    super(context,attrs);
    init(context, attrs, 0);
}

public MyView(Context context, AttributeSet attrs, int defStyle) {
    super(context, attrs, defStyle);
    init(context, attrs, defStyle);
}

private void init(Context context, AttributeSet attrs, int defStyle) {
    // do additional work
}

原因是自定义View的父控件可能在构造方法中设置了默认的defStyle。以TextView(Button等也可)的构造方法为例,如果使用this级联调用,而不是super(context),控件就丢失了应用当前theme下R.attr.textViewStyle中定义的默认属性。

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

public TextView(Context context, @Nullable AttributeSet attrs) {
    this(context, attrs, com.android.internal.R.attr.textViewStyle);
}

public TextView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
    this(context, attrs, defStyleAttr, 0);
}

公共Attribute定义

一个module的Attribute定义中不能出现同名属性,即使同名属性位于多个attrs.xml文件。这时候可参考系统公共属性的定义,解决方法如下:

<resources>

    <!-- 公共属性 -->
    <attr name="useSkin" format="boolean"/>

    <declare-styleable name="CustomHeaderLoadingLayout">
        <attr name="headerBackground" format="reference"/>
        <attr name="loadingViewType">
            <enum name="colored" value="0"/>
            <enum name="white" value="1"/>
        </attr>
        <attr name="showTip" format="boolean"/>
        <attr name="tipTextColor" format="color|reference"/>
        <attr name="useSkin" />
    </declare-styleable>

    <declare-styleable name="DragBubbleView">
        <attr name="bubbleRadius" format="dimension" />
        <attr name="bubbleColor" format="color" />
        <attr name="bubbleTextPadding" format="dimension" />
        <attr name="bubbleTextSize" format="dimension" />
        <attr name="bubbleTextColor" format="color" />
        <attr name="useSkin"/>
    </declare-styleable>
</resources>

其实只要保证只有一处属性定义语句<attr name="useSkin" format="boolean"/>(也可在某个declare-styleable内定义),可在多个地方进行属性的引用 <attr name="useSkin"/>

参考文档:
https://blog.danlew.net/2016/07/19/a-deep-dive-into-android-view-constructors/
https://stackoverflow.com/questions/9195713/do-i-need-all-three-constructors-for-an-android-custom-view/34301725#34301725
Android 深入理解Android中的自定义属性
Android View构造方法第三参数使用方法详解

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容