欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

理解Android中的自定义属性

程序员文章站 2024-02-21 18:47:22
本文实例讲解了android中的自定义属性,具体内容如下 1、引言 对于自定义属性,大家肯定都不陌生,遵循以下几步,就可以实现: 自定义一个customvie...

本文实例讲解了android中的自定义属性,具体内容如下

1、引言

对于自定义属性,大家肯定都不陌生,遵循以下几步,就可以实现:

  • 自定义一个customview(extends view )类
  • 编写values/attrs.xml,在其中编写styleable和item等标签元素
  • 在布局文件中customview使用自定义的属性(注意namespace)
  • 在customview的构造方法中通过typedarray获取

ps:如果你对上述几个步骤不熟悉,建议先熟悉下,再继续~
那么,我有几个问题:

  • 以上步骤是如何奏效的?
  • styleable 的含义是什么?可以不写嘛?我自定义属性,我声明属性就好了,为什么一定要写个styleable呢?
  • 如果系统中已经有了语义比较明确的属性,我可以直接使用嘛?
  • 构造方法中的有个参数叫做attributeset
    (eg: mytextview(context context, attributeset attrs) )这个参数看名字就知道包含的是参数的数组,那么我能不能通过它去获取我的自定义属性呢?
  • typedarray是什么鬼?从哪冒出来的,就要我去使用?

恩,针对这几个问题,大家可以考虑下,如何回答呢?还是说:老子会背上述4个步骤就够了~~

2、常见的例子

接下来通过例子来回答上述问题,问题的回答顺序不定~~大家先看一个常见的例子,即上述几个步骤的代码化。

自定义属性的声明文件

  <?xml version="1.0" encoding="utf-8"?>
<resources>

  <declare-styleable name="test">
    <attr name="text" format="string" />
    <attr name="testattr" format="integer" />
  </declare-styleable>

</resources>

自定义view类

package com.example.test;

import android.content.context;
import android.content.res.typedarray;
import android.util.attributeset;
import android.util.log;
import android.view.view;

public class mytextview extends view {

  private static final string tag = mytextview.class.getsimplename();

  public mytextview(context context, attributeset attrs) {
    super(context, attrs);

    typedarray ta = context.obtainstyledattributes(attrs, r.styleable.test);

    string text = ta.getstring(r.styleable.test_testattr);
    int textattr = ta.getinteger(r.styleable.test_text, -1);

    log.e(tag, "text = " + text + " , textattr = " + textattr);

    ta.recycle();
  }

}

布局文件中使用

<relativelayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  xmlns:zhy="http://schemas.android.com/apk/res/com.example.test"
  android:layout_width="match_parent"
  android:layout_height="match_parent" >

  <com.example.test.mytextview
    android:layout_width="100dp"
    android:layout_height="200dp"
    zhy:testattr="520"
    zhy:text="helloworld" />

</relativelayout>

ok,大家花3s扫一下,运行结果为:

 mytextview: text = helloworld , textattr = 520

应该都不意外吧,注意下,我的styleable的name写的是test,所以说这里并不要求一定是自定义view的名字。

3、attributeset与typedarray

下面考虑:

构造方法中的有个参数叫做attributeset(eg: mytextview(context context, attributeset attrs) )这个参数看名字就知道包含的是参数的集合,那么我能不能通过它去获取我的自定义属性呢?
首先attributeset中的确保存的是该view声明的所有的属性,并且外面的确可以通过它去获取(自定义的)属性,怎么做呢?
其实看下attributeset的方法就明白了,下面看代码。

public mytextview(context context, attributeset attrs) {
    super(context, attrs);

    int count = attrs.getattributecount();
    for (int i = 0; i < count; i++) {
      string attrname = attrs.getattributename(i);
      string attrval = attrs.getattributevalue(i);
      log.e(tag, "attrname = " + attrname + " , attrval = " + attrval);
    }

    // ==>use typedarray ...

  }

输出:

mytextview(4136): attrname = layout_width , attrval = 100.0dip
mytextview(4136): attrname = layout_height , attrval = 200.0dip
mytextview(4136): attrname = text , attrval = helloworld
mytextview(4136): attrname = testattr , attrval = 520

结合上面的布局文件,你发现了什么?
我擦,果然很神奇,真的获得所有的属性,恩,没错,通过attributeset可以获得布局文件中定义的所有属性的key和value(还有一些方法,自己去尝试),那么是不是说typedarray这个鬼可以抛弃了呢?答案是:no!。

现在关注下一个问题:

typedarray是什么鬼?从哪冒出来的,就要我去使用?
我们简单修改下,布局文件中的mytextview的属性。

<com.example.test.mytextview
    android:layout_width="@dimen/dp100"
    android:layout_height="@dimen/dp200"
    zhy:testattr="520"
    zhy:text="@string/hello_world" />

现在再次运行的结果是:

mytextview(4692): attrname = layout_width , attrval = @2131165234
mytextview(4692): attrname = layout_height , attrval = @2131165235
mytextview(4692): attrname = text , attrval = @2131361809
mytextview(4692): attrname = testattr , attrval = 520
>>use typedarray
mytextview(4692): text = hello world! , textattr = 520

发现了什么?通过attributeset获取的值,如果是引用都变成了@+数字的字符串。你说,这玩意你能看懂么?那么你看看最后一行使用typedarray获取的值,是不是瞬间明白了什么。

typedarray其实是用来简化我们的工作的,比如上例,如果布局中的属性的值是引用类型(比如:@dimen/dp100),如果使用attributeset去获得最终的像素值,那么需要第一步拿到id,第二步再去解析id。而typedarray正是帮我们简化了这个过程。

贴一下:如果通过attributeset获取最终的像素值的过程:

int widthdimensionid = attrs.getattributeresourcevalue(0, -1);
    log.e(tag, "layout_width= "+getresources().getdimension(widthdimensionid));

ok,现在别人问你typedarray存在的意义,你就可以告诉他了。

4、declare-styleable

我们已经解决了两个问题,接下来,我们看看布局文件,我们有一个属性叫做:zhy:text。
总所周知,系统提供了一个属性叫做:android:text,那么我觉得直接使用android:text更nice,这样的话,考虑问题:

如果系统中已经有了语义比较明确的属性,我可以直接使用嘛?
答案是可以的,怎么做呢?
直接在attrs.xml中使用android:text属性。

<declare-styleable name="test">
    <attr name="android:text" />
    <attr name="testattr" format="integer" />
  </declare-styleable>

注意,这里我们是使用已经定义好的属性,不需要去添加format属性(注意声明和使用的区别,差别就是有没有format)。
然后在类中这么获取:ta.getstring(r.styleable.test_android_text);布局文件中直接android:text="@string/hello_world"即可。

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

ok,接下来,我在想,既然declare-styleable这个标签的name都能随便写,这么随意的话,那么考虑问题:

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

首先删除declare-styleable的标签
那么现在的attrs.xml为:

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <attr name="testattr" format="integer" />
</resources>

* mytextview实现

package com.example.test;

import android.content.context;
import android.content.res.typedarray;
import android.util.attributeset;
import android.util.log;
import android.view.view;

public class mytextview extends view {

  private static final string tag = mytextview.class.getsimplename();

  private static final int[] mattr = { android.r.attr.text, r.attr.testattr };
  private static final int attr_android_text = 0;
  private static final int attr_testattr = 1;

  public mytextview(context context, attributeset attrs) {
    super(context, attrs);

    // ==>use typedarray
    typedarray ta = context.obtainstyledattributes(attrs, mattr);

    string text = ta.getstring(attr_android_text);
    int textattr = ta.getinteger(attr_testattr, -1);
    //输出 text = hello world! , textattr = 520
    log.e(tag, "text = " + text + " , textattr = " + textattr);

    ta.recycle();
  }

}

貌似多了些代码,可以看到我们声明了一个int数组,数组中的元素就是我们想要获取的attr的id。并且我们根据元素的在数组中的位置,定义了一些整形的常量代表其下标,然后通过typedarray进行获取。
可以看到,我们原本的:

r.styleable.test => mattr
r.styleable.test_text => attr_android_text(0)
r.styleable.test_testattr => attr_testattr(1)

那么其实呢?android在其内部也会这么做,按照传统的写法,它会在r.java生成如下代码:

public static final class attr {
  public static final int testattr=0x7f0100a9;
  }
public static final class styleable {
   public static final int test_android_text = 0;
   public static final int test_testattr = 1;
   public static final int[] test = {
      0x0101014f, 0x7f0100a9
    };
  }

ok,根据上述你应该发现了什么。styleale的出现系统可以为我们完成很多常量(int[]数组,下标常量)等的编写,简化我们的开发工作(想想如果一堆属性,自己编写常量,你得写成什么样的代码)。那么大家肯定还知道declare-styleable的name属性,一般情况下写的都是我们自定义view的类名。主要为了直观的表达,该declare-styleable的属性,都是改view所用的。

其实了解该原理是有用的,详见:android 自定义控件 优雅实现元素间的分割线

ok,现在5个问题,回答了4个,第一个问题:

自定义属性的几个步骤是如何奏效的?
恩,上述以及基本涵盖了这个问题的答案,大家自己总结,所以:略。

总结:

  • attrs.xml里面的declare-styleable以及item,android会根据其在r.java中生成一些常量方便我们使用(aapt干的),本质上,我们可以不声明declare-styleable仅仅声明所需的属性即可。
  • 我们在view的构造方法中,可以通过attributeset去获得自定义属性的值,但是比较麻烦,而typedarray可以很方便的便于我们去获取。
  • 我们在自定义view的时候,可以使用系统已经定义的属性。

以上就是关于android中的自定义属性的相关内容,希望对大家的学习有所帮助。