android training (自定义view第一节)

创建自定义view

一个设计良好的的自定义view应该是一个设计良好的class,它包含了很多实用的功能,让人们更加容易使用接口。它充分利用GPU与内存的性能等等。
另外作为一个设计良好的类,一个自定义view还应该有以下特性:

  • 遵从android标准
  • 提供可以在layout中使用的自定义属性
  • 兼顾各种人士需求(比如视力,听力)
  • 兼容各种android平台版本

android的sdk提供了一系列的基础的类和xml的标记来帮助你创建一个满足你需求的自定义view。本节课将讨论如何利用android的framwork来创建一个有基本核心功能的自定义view。

继承一个view


android系统framwork层的view都是继承自View这个基类。你的自定义view也可以直接继承自View,或者你为了节省时间可以继承一个已经存在的子类,比如Button。

为了让Android Developer Tools 能和你的自定义view交互,你必须最少提供一个接受Context和AttributeSet为参数的构造函数。通过这个构造函数,layout编辑器可以创建和编辑你的自定义view的实例。(也就是可以在未运行的时候,展示出界面)

class PieChart extends View {
    public PieChart(Context context, AttributeSet attrs) {
        super(context, attrs);
    }
}

定义自定义的属性

为了向你的界面中添加一个内建的view,你需要在xml元素里面指定,然后通过元素的属性控制它的显示和行为。为了做到这一点,你必须:

  • <declare-styleable>资源属性下为你的自定义view定义属性
  • 在xml layout中指定属性的值
  • 在运行的时候,接受属性的值
  • 将接受的值应用到你的view中去

这一节讨论了如何定义自定义的属性与指定他们的值。下一节将处理在运行时接收与应用属性的值。

为了定义自定义属性,添加<declare-styleable>资源到你的工程中。通常我们会将这些资源放到res/values/attrs.xml文件中。下面是一个例子:

<resources>
    <declare-styleable name="PieChart">
        <attr name="showText" format="boolean" />
        <attr name="labelPosition" format="enum">
            <enum name="left" value="0"/>
            <enum name="right" value="1"/>
        </attr>
    </declare-styleable>
</resources>

上面的代码声明了两个自定义属性,showtextlablePosition,这两个属性属于styleable 实体,命名为PieChart,styleable实体的命名通常为了方便,和你的自定义view的名字一样。尽管这不是一个严格的规定,但是很多非常流行的开源代码的作者也是遵从这个原则。

一旦你定义了自定义属性,你就可以像内置的android属性那样来运用你的属性。唯一的不同就是你的自定义属性是属于一个不同的命名空间的。他们不是属于http://schemas.android.com/apk/res/android这个命名空间,而是属于http://schemas.android.com/apk/res/[your package name]这个命名空间。例如,下面是如何使用PieChart的属性:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:custom="http://schemas.android.com/apk/res/com.example.customviews">
 <com.example.customviews.charting.PieChart
     custom:showText="true"
     custom:labelPosition="left" />
</LinearLayout>

为了避免重复这么长的命名空间,上面的例子使用了一个xmlns指示符。这个指示符把custom这个名字赋值给了http://schemas.android.com/apk/res-auto这个命名空间。
你可以选择任何的同名简化单词来替代你的命名空间。

Note:如果你没有使用gradle来构建你的系统,你的xlmns URI不能包含 res-auto 。这个URI比较包含完整的你的项目的名字。这个例子中,如果不是grale构建的话,URI应该为http://schemas.android.com/apk/res/com.example.customviews

请注意你在xml中指定的你的自定义view的名字。这个名字必须是这个类完整的类路径。如果你的自定义view是一个inner class,你必须讲outer class的名字也加上。例如,这个PieChart类如果有一个inner class 叫PieView.为了使用这个自定义view的属性,你应该这样写你的tag com.example.customviews.charting.PieChart$PieView

属性值的应用

当一个view从xml layout中创建出来后,所有的在xml tag中的属性就会从resourse bundle中读取出来并且传递给view的构造函数的参数AttributeSet.尽管我们可以直接从AttributeSet中读取属性值,但是这样做有一些缺点。

  • 资源的引用的属性值没有被分解出来
  • Styles没有被应用到属性值上

于是,我们把AttrbuteSet传递给obtainStyledAttributes()这个函数。这个函数会返回一个TypedArray,这个一系列的值,经过了解引用,同时将主题样式应用到值上。

Android的资源编译器在你调用obtainStyledAttributes()之前,做了很多工作。遍历res目录中<declare-styleable>资源的时候,生成了R.java文件,这个文件包含了一个属性id的数组与属性在数组中的次序。你通过预先定义的常量来从TypedArray中读取属性值。下面是PieChart如何读取他自己的属性的例子:

public PieChart(Context context, AttributeSet attrs) {
   super(context, attrs);
   TypedArray a = context.getTheme().obtainStyledAttributes(
        attrs,
        R.styleable.PieChart,
        0, 0);

   try {
       mShowText = a.getBoolean(R.styleable.PieChart_showText, false);
       mTextPos = a.getInteger(R.styleable.PieChart_labelPosition, 0);
   } finally {
       a.recycle();
   }
}

请注意Typedarray对象是一个共享的资源,所以每次使用完毕后,请及时调用recycle方法。

添加类属性与事件

xml的属性是一个很强大的控制view显示与行为的方式,但是它们却只能在view初始化的时候来读取。为了提供动态的行为,我们可以为每一个xml属性提供get与set方法。下面代码片段展示了如何向外部提供一个get与set接口:

public boolean isShowText() {
   return mShowText;
}

public void setShowText(boolean showText) {
   mShowText = showText;
   invalidate();
   requestLayout();
}

注意下,setShowText方法调用了invalidate()与requestLayout().这些调用很重要,是用来保证view的行为是可靠的。当你修改了一些可能影响view显示的属性时,你必须invalidate你的view,这样系统就可以知道这个view需要重新绘制。同样的,当你修改了一些影响view大小与形状的属性时,你必须调用requestLayout。忘记调用这个函数,可能到导致很多难以发现的bug。

自定义view也应该支持一些事件的监听。例如,PieChart向外提供一个叫做 OnCurrentItemChanged方法,来通知监听者用户已经旋转了pie chart。

我们很容易就忘记向外提供属性与事件监听,尤其是当这个自定义view只有我们一个人使用的时候。花一些时间来定义这些view的接口,这样可以节省以后维护的成本花费。一个好的做法就是,将所有影响显示与行为的属性都向外提供接口。

定义可接受性

你的自定义view应该尽可能支持更多的用户。包括视力,或者行动不方便的人士。为了支持这些人,你应该:

  • 在你的输入性的控件上面使用 android:contentDescription这个属性
  • 在合适的时间通过调用sendAccessiblityEvent发送兼容性事件
  • 支持交叉输入控制,比如轨迹球,D-pad

更多的关于创建兼容view的知识,请查看 Making Application Accessible

发表评论

电子邮件地址不会被公开。 必填项已用*标注