如何：定义自定义小部件的主题（样式）项

Question

我为我们在整个应用程序中广泛使用的控件编写了一个自定义小部件。小部件类派生自ImageButton，并以几种简单的方式对其进行了扩展。我已经定义了一种样式，可以在使用时将其应用于小部件，但我更喜欢通过主题进行设置。在R.styleable中，我看到了imageButtonStyle和textViewStyle等小部件样式属性。有没有办法为我编写的自定义小部件创建类似的东西？

Answer 1

是的，有一种方法：

假设您有一个小部件的属性声明（在 attrs.xml 中）：

<declare-styleable name="CustomImageButton">
    <attr name="customAttr" format="string"/>
</declare-styleable>

声明一个将用于样式引用的属性（在 attrs.xml 中） code>)：

<declare-styleable name="CustomTheme">
    <attr name="customImageButtonStyle" format="reference"/>
</declare-styleable>

为小部件声明一组默认属性值（在 styles.xml 中）：

<style name="Widget.ImageButton.Custom" parent="android:style/Widget.ImageButton">
    <item name="customAttr">some value</item>
</style>

声明自定义主题（在 themes.xml 中）：

<style name="Theme.Custom" parent="@android:style/Theme">
    <item name="customImageButtonStyle">@style/Widget.ImageButton.Custom</item>
</style>

将此属性用作小部件构造函数中的第三个参数（在 CustomImageButton.java 中）：

public class CustomImageButton extends ImageButton {
    private String customAttr;

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

    public CustomImageButton( Context context, AttributeSet attrs ) {
        this( context, attrs, R.attr.customImageButtonStyle );
    }

    public CustomImageButton( Context context, AttributeSet attrs,
            int defStyle ) {
        super( context, attrs, defStyle );

        final TypedArray array = context.obtainStyledAttributes( attrs,
            R.styleable.CustomImageButton, defStyle,
            R.style.Widget_ImageButton_Custom ); // see below
        this.customAttr =
            array.getString( R.styleable.CustomImageButton_customAttr, "" );
        array.recycle();
    }
}

现在您必须将 Theme.Custom 应用于所有使用 CustomImageButton 的活动（在 AndroidManifest.xml 中）：

<activity android:name=".MyActivity" android:theme="@style/Theme.Custom"/>

仅此而已。现在，CustomImageButton 尝试从当前主题的 customImageButtonStyle 属性加载默认属性值。如果在主题中找不到此类属性或属性值为 @null，则将使用 obtainStyledAttributes 的最终参数：Widget.ImageButton.Custom > 在这种情况下。

您可以更改所有实例和所有文件的名称（AndroidManifest.xml 除外），但最好使用 Android 命名约定。

Answer 2

除了迈克尔的出色答案之外，另一个方面是覆盖主题中的自定义属性。
假设您有许多自定义视图，它们都引用自定义属性“custom_background”。

<declare-styleable name="MyCustomStylables">
    <attr name="custom_background" format="color"/>
</declare-styleable>

在主题中，您定义值是什么

<style name="MyColorfulTheme" parent="AppTheme">
    <item name="custom_background">#ff0000</item>
</style>

，或者

<style name="MyBoringTheme" parent="AppTheme">
    <item name="custom_background">#ffffff</item>
</style>

您可以在样式中引用该属性

<style name="MyDefaultLabelStyle" parent="AppTheme">
    <item name="android:background">?background_label</item>
</style>

注意问号，也用于参考 android 属性，如

?android:attr/colorBackground

你们大多数人已经注意到的那样，您可以 - 并且可能应该 - 使用 @color参考而不是硬编码的颜色。

那么为什么不做

<item name="android:background">@color/my_background_color</item>

你不能在运行时更改“my_background_color”的定义，而你可以轻松切换主题。