Ресурс списка состояний цвета

ColorStateList – это объект, который можно определить в XML и применить в качестве цвета, который меняется в зависимости от состояния объекта View, к которому он применяется. Например, виджет Button может находиться в одном из нескольких состояний: нажатом, выделенном или ни в одном из них. Используя список состояний цвета, вы можете указать разные цвета для каждого состояния.

Список состояний описывается в XML-файле. Каждый цвет определяется в элементе <item> внутри одного элемента <selector>. Каждый <item> использует различные атрибуты для описания состояния, в котором он используется.

При каждом изменении состояния список состояний просматривается сверху вниз, и используется первый элемент, соответствующий текущему состоянию. Выбор не основан на "наилучшем" совпадении, а скорее на первом элементе, который соответствует минимальным критериям состояния.

Примечание. Если вы хотите предоставить статический ресурс цвета, используйте простое значение color.

местоположение файла;
res/color/filename.xml
Название файла используется в качестве идентификатора ресурса.
скомпилированный тип данных ресурса:
Указатель ресурса на ColorStateList
ссылка на ресурс:
В Java: R.color.filename
В XML: @[package:]color/filename
Синтаксис:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:color="hex_color"
        android:lStar="floating_point_value"
        android:state_pressed=["true" | "false"]
        android:state_focused=["true" | "false"]
        android:state_selected=["true" | "false"]
        android:state_checkable=["true" | "false"]
        android:state_checked=["true" | "false"]
        android:state_enabled=["true" | "false"]
        android:state_window_focused=["true" | "false"] />
</selector>
elements:
<selector>
Обязательный атрибут. Это корневой элемент. Содержит один или несколько элементов <item>.

Атрибуты:

xmlns:android
Строка. Обязательно. Определяет пространство имен XML, которое имеет значение "http://schemas.android.com/apk/res/android".
<item>
Определяет цвет, который будет использоваться в определенных состояниях, описанных его атрибутами. Это дочерний элемент тега <selector>.

Атрибуты:

android:color
Шестнадцатеричный код цвета. Обязательный параметр. Цвет задается значением RGB и необязательным альфа-каналом.

Значение всегда начинается с символа решетки (#), за которым следует информация о прозрачности, красном, зеленом и синем цветах в одном из следующих форматов:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB
android:lStar
Число с плавающей запятой. Необязательно. Этот атрибут изменяет воспринимаемую яркость базового цвета. В качестве значения используется запись с плавающей запятой от 0 до 100 или атрибут темы, который распознается как такое число. Общий цвет элемента рассчитывается путем преобразования базового цвета в цветовое пространство, удобное для специальных возможностей, и установки его L* в значение, указанное в атрибуте lStar.

Пример: android:lStar="50"

android:state_pressed
Логическое значение. "true", если этот элемент используется при нажатии на объект, например при касании или нажатии кнопки. Если элемент используется в состоянии по умолчанию (не нажат), то значение равно "false".
android:state_focused
Логическое значение. "true" – если элемент используется, когда объект находится в фокусе, например когда кнопка выделена с помощью трекбола или d-pad. Если элемент используется по умолчанию и не находится в фокусе, то значение равно "false".
android:state_selected
Логическое значение. "true", если этот элемент используется при выборе объекта, например при открытии вкладки. Если объект не выбран, значение будет "false".
android:state_checkable
Логическое значение. "true", если этот элемент используется, когда объект можно отметить. Если объект не поддерживает выбор, возвращается значение "false". Используется, только если объект может переключаться между виджетом с возможностью выбора и виджетом без нее.
android:state_checked
Логическое значение. "true", если этот элемент используется, когда объект выбран. Если объект не выбран, то используется "false".
android:state_enabled
Логическое значение. "true", если этот элемент используется, когда объект включен и может получать события касания или клика. Если объект отключен, то используется "false".
android:state_window_focused
Логическое значение. "true", если этот элемент используется, когда окно приложения находится в фокусе, то есть приложение работает на переднем плане. Значение "false" используется, если элемент применяется, когда окно приложения неактивно, например если открыта панель уведомлений или диалоговое окно.

Примечание. Применяется первый элемент в списке состояний, который соответствует текущему состоянию объекта. Если первый элемент в списке не содержит ни одного из предыдущих атрибутов состояния, он применяется каждый раз. Поэтому значение по умолчанию должно быть последним, как показано в примере ниже.

пример:
XML-файл сохранен в res/color/button_text.xml:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_pressed="true"
          android:color="#ffff0000"/> <!-- pressed -->
    <item android:state_focused="true"
          android:color="#ff0000ff"/> <!-- focused -->
    <item android:color="#ff000000"/> <!-- default -->
</selector>

В следующем XML-файле макета список цветов применяется к View:

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/button_text"
    android:textColor="@color/button_text" />
См. также: