创建自定义view(翻译 androidtraining)

创建自定义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>

上面的代码声明了两个自定义属性，showtext与lablePosition，这两个属性属于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