Списки: спецификации
Списки — это непрерывные вертикальные последовательности текста и изображений.
Варианты
Выразительные списки
Используйте выразительный вариант списка для более гибкого оформления, визуального выделения выбранных состояний и настраиваемых слотов.

Базовые списки
Базовые списки по-прежнему доступны, но не включают новейший визуальный стиль, оформление выбора и функциональность слотов.
В веб-реализации выразительные списки построены на основе базовых.
См. спецификации базового списка

| Варианты | M3 | M3 Expressive |
|---|---|---|
| Списки (выразительные) | -- | Доступно |
| Списки (базовые) | Доступно | Не рекомендуются. Вместо них используйте выразительные списки. |
Конфигурации
Стили
Стандартный и сегментированный стили относятся только к визуальному оформлению и не влияют на поведение списка.

- Стандартный
- Сегментированный
Выбор в списке
Список может одновременно поддерживать только один режим выбора. Например, список с одним действием может стать списком с множественным выбором, но не может совмещать оба режима.




Взаимодействия со списком
Списки поддерживают:
Подробнее о доступности взаимодействий со списком

| Категория | Конфигурация | M3 | M3 Expressive |
|---|---|---|---|
| Стили | Стандартный | Доступно | Доступно |
| Сегментированный | -- | Доступно | |
| Режимы выбора | С одним действием, с несколькими действиями, с одиночным выбором, с множественным выбором | Доступно | Доступно |
| Взаимодействия | Разворачивание, смахивание\* | Доступно | Доступно |
* Взаимодействия «смахивание для показа действий» доступны только в Android Views
Токены и спецификации
Используйте выпадающее меню таблицы, чтобы выбрать набор токенов. Набор common объединяет базовые токены с новыми выразительными формами и размерами. Набор expand содержит токены для взаимодействия «разворачивание». Подробнее о дизайн-токенах
Список — Common
Список — Expand
Анатомия

Контейнер и текст метки обязательны. Все остальные элементы необязательны:
- Контейнер
- Надстрочная метка
- Текст метки
- Завершающий текст
- Вспомогательный текст
- Завершающий значок
- Разделитель
- Ведущий аватар
- Ведущий значок
- Ведущий медиаэлемент — изображение или видео
Гибкость и слоты
M3 Design Kit включает списки с настраиваемыми слотами для проектирования гибких макетов элементов. Представьте настраиваемый список как контейнер с тремя слотами: ведущим, контентным и завершающим. Каждый слот может содержать собственный элемент.
Доступность слотов
Слоты по умолчанию не являются доступными. Учтите следующее:
- Элементы должны соответствовать правилам, структуре и паттернам взаимодействия для списков
- Используйте стандартные отступы элемента списка
- Размер области касания должен быть не менее 48×48 dp
- Не добавляйте интерактивные элементы, которые затрудняют навигацию по элементу списка, особенно для людей, использующих программы чтения с экрана

- Ведущий слот
- Слот контента
- Завершающий слот
WARNING
Использование слотов требует пользовательского кода, который нужно создать и поддерживать.
Ширина ведущего и завершающего слотов должна быть меньше ширины секции контента.
1. Ведущие слоты могут содержать:
- Визуальные элементы: аватар, значок, изображение или миниатюру видео
- Элементы управления выбором: флажок, радиокнопку или переключатель
- Дополнительное оформление: бейдж или увеличенное изображение
2. Слот контента должен быть самым широким и может содержать:
- Содержимое по умолчанию: текст метки, вспомогательный текст
- Дополнительные элементы: бейдж, значок, встроенную метку или другие текстовые элементы
- Избегайте длинных строк текста, чтобы сохранить читаемость
3. Завершающие слоты могут содержать:
- Элементы действий или текст: значок, кнопку со значком или завершающий текст
- Элементы управления выбором: флажок, радиокнопку или переключатель

Списки выбора
В списках выбора допускается только одно взаимодействие выбора на каждый элемент списка.


Цвет
Цвета задаются дизайн-токенами. Для дизайнеров это означает работу со значениями цвета, соответствующими токенам. При реализации значение цвета будет токеном, который ссылается на конкретное значение. Подробнее о дизайн-токенах

Цветовые роли списка, используемые для светлой и тёмной тем:
- Поверхность
- Вариант «на поверхности»
- На поверхности
- Вариант «на поверхности»
- Вариант «на поверхности»
- Вариант «на поверхности»
- Вариант контура
- Основной контейнер
- На основном контейнере
- Вариант «на поверхности»
Состояния
Состояния — это визуальные отображения, передающие состояние компонента или интерактивного элемента. Подробнее о состояниях взаимодействия
Элементы списка по умолчанию

- Включено
- Отключено
- Наведение
- Фокус
- Нажатие
- Перетаскивание
Выбранные элементы списка

- Включено
- Отключено
- Наведение
- Фокус
- Нажатие
- Перетаскивание
Размеры

Морфинг формы
Когда элемент списка выбран, форма его углов меняется, чтобы выделить активный элемент:
- Радиус скругления углов невыбранного элемента: внутренний — 4 dp, внешний — 16 dp
- Радиус скругления углов выбранного элемента: 16 dp


Список (базовый)
Вариант базового списка доступен и продолжает работать в существующих продуктах. Однако для новых дизайнов рекомендуется вариант выразительного списка.
Токены и спецификации
Токены базового списка входят в набор common.TIP
Набор common также включает несколько токенов выразительного списка.
Цвет
Цвета задаются дизайн-токенами. Для дизайнеров это означает работу со значениями цвета, соответствующими токенам. При реализации значение цвета будет токеном, который ссылается на конкретное значение. Подробнее о дизайн-токенах

Цветовые роли списка, используемые для светлой и тёмной тем:
- Поверхность
- На поверхности
- Вариант «на поверхности»
- Вариант «на поверхности»
- Вариант «на поверхности»
- Вариант контура
- Основной контейнер
- На основном контейнере
- Вариант «на поверхности»
Состояния
Состояния — это визуальные отображения, передающие состояние компонента или интерактивного элемента.

- Включено
- Отключено
- Наведение
- Фокус
- Нажатие
- Перетаскивание
Макет
Однострочные списки


Двухстрочные списки


Трёхстрочные списки


| Атрибут | Значение |
|---|---|
| Выравнивание метки | По центру |
| Выравнивание метки, когда высота — 88 dp и более | По верху |
| Отступ метки слева | 16 dp |
| Выравнивание ведущего элемента (по вертикали) | По центру |
| Выравнивание ведущего элемента (по вертикали), когда высота — 88 dp и более | По верху |
| Отступ ведущего элемента слева | 16 dp |
| Выравнивание ведущего значка (по вертикали) | По верху |
| Верхний отступ ведущего значка | 8 dp |
| Верхний отступ ведущего значка, когда высота — 88 dp и более | 12 dp |
| Выравнивание завершающего элемента (по вертикали) | По центру |
| Выравнивание завершающего элемента (по вертикали), когда высота — 88 dp и более | По верху |
| Отступ завершающего элемента слева | 16 dp |
| Отступ завершающего элемента справа | 24 dp |
| Отступы сверху и снизу разделителя | 0 dp |
| Области касания | 48 dp |
| Разделитель на всю ширину | 100% |
| Отступ разделителя-вставки слева | 16 dp |
| Отступ разделителя-вставки справа | 24 dp |
Конфигурации
Ведущий аватар

- С ведущим аватаром
- С ведущим аватаром и завершающим флажком
Ведущее изображение или миниатюра

- С ведущим изображением
- С ведущим изображением и завершающим флажком
Ведущее видео

- С ведущим видео
- С ведущим видео и завершающим флажком
Ведущий значок

- С ведущим значком
- С ведущим значком и завершающим флажком
Только текст

- Только текст
- С текстом и завершающим флажком
Ведущий флажок

- С ведущим флажком
- С ведущим флажком и завершающим текстом
Ведущая радиокнопка

- С ведущей радиокнопкой
- С ведущей радиокнопкой и завершающим текстом
Завершающий переключатель

- С завершающим переключателем
- С ведущим значком и завершающим переключателем