从零开始：掌握 TypedArray，详解 Android 自定义 View 属性

2024-01-29 16:27:44

Android 中 TypedArray 的魔力

在 Android 开发中，自定义 View 和 ViewGroup 是创建独特且可重用的 UI 组件的常用方法。为了让这些组件能够适应不同的需求，我们需要为它们添加自定义属性。这些属性允许您在 XML 布局文件中配置组件的外观和行为，从而无需在代码中硬编码这些值。

而当您想将这些自定义属性添加到您的组件时，TypedArray 就派上用场了。TypedArray 是 Android 提供的一种类，它允许您轻松地解析 XML 布局文件中的属性值。通过 TypedArray，您可以访问属性的值，并根据需要使用它们来配置组件。

入门：创建自定义 View 和属性

为了更好地理解 TypedArray 的工作原理，让我们从头开始创建一个简单的自定义 View 并为其添加一些自定义属性。

1. 创建自定义 View

首先，创建一个新的 Android 项目。在 res/layout 目录下创建一个 XML 布局文件，例如 custom_view.xml。在此文件中，添加如下代码：

<com.example.myapplication.CustomView
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

CustomView 是您要创建的自定义 View 的名称。它继承自 View 类，这是所有 Android 视图组件的基类。

2. 定义自定义属性

接下来，为您的自定义 View 定义一些自定义属性。打开 res/values/attrs.xml 文件，并添加以下代码：

<declare-styleable name="CustomView">
    <attr name="custom_text" format="string" />
    <attr name="custom_color" format="color" />
</declare-styleable>

custom_text 和 custom_color 是您要添加的自定义属性的名称。format 属性指定了属性值的格式。string 表示该属性的值将是一个字符串，color 表示该属性的值将是一个颜色。

使用 TypedArray 解析自定义属性

现在，我们已经定义了自定义 View 和属性，我们需要使用 TypedArray 来解析这些属性的值。

1. 获取 TypedArray

在您的自定义 View 的构造函数中，您可以使用 TypedArray 来获取 XML 布局文件中的属性值。如下所示：

public CustomView(Context context, AttributeSet attrs) {
    super(context, attrs);

    TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.CustomView);

    String customText = typedArray.getString(R.styleable.CustomView_custom_text);
    int customColor = typedArray.getColor(R.styleable.CustomView_custom_color, Color.BLACK);

    typedArray.recycle();
}