Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.
Ресурс списка состояний цвета
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
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" />
- См. также:
-
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2026-11-19 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2026-11-19 UTC."],[],[]]