it-swarm.com.ru

Как: определить тему (стиль) для пользовательского виджета

Я написал собственный виджет для элемента управления, который мы широко используем в нашем приложении. Класс виджета происходит от ImageButton и расширяет его несколькими простыми способами. Я определил стиль, который я могу применить к виджету по мере его использования, но я бы предпочел настроить его с помощью темы. В R.styleable я вижу атрибуты стиля виджета, такие как imageButtonStyle и textViewStyle. Есть ли способ создать что-то подобное для пользовательского виджета, который я написал?

81
jsmith

Да, есть один способ:

Предположим, у вас есть объявление атрибутов для вашего виджета (в attrs.xml):

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

Объявите атрибут, который вы будете использовать для ссылки на стиль (в attrs.xml):

<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.

205
Michael

Еще один аспект в дополнение к отличному ответу Майкла - переопределение пользовательских атрибутов в темах. Предположим, у вас есть несколько пользовательских представлений, которые все ссылаются на пользовательский атрибут "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" во время выполнения, тогда как вы можете легко переключать темы.

4
mir