Кнопки со значками: спецификации
Кнопки со значками позволяют выполнять действия одним нажатием.
Варианты

- Кнопка со значком по умолчанию
- Переключаемая кнопка со значком
| Вариант | M3 | M3 Expressive |
|---|---|---|
| По умолчанию | Доступно | Доступно |
| Переключаемая (с выбором состояния) | Доступно | Доступно |
Конфигурации

- Пять размеров
- Две формы
- Четыре цветовых стиля
- Три варианта ширины
| Категория | Параметры | M3 | M3 Expressive |
|---|---|---|---|
| Размер | Малый (по умолчанию) | Доступно | Доступно |
| XS, M, L, XL | -- | Доступно | |
| Форма | Круглая (по умолчанию) | Доступно | Доступно |
| Квадратная | -- | Доступно | |
| Цвет | Заполненный (по умолчанию), тональный, контурный, стандартный | Доступно | Доступно |
| Ширина | По умолчанию | Доступно | Доступно |
| Узкая, широкая | -- | Доступно |
Токены и спецификации
Наборы токенов кнопок со значками сгруппированы по общим токенам, цвету и размеру. Выберите нужный набор в меню таблицы. Подробнее о дизайн-токенах
Кнопка со значком — Цвет — Заполненная
Кнопка со значком — Цвет — Тональная
Кнопка со значком — Цвет — Контурная
Кнопка со значком — Цвет — Стандартная
Кнопка со значком — Размер — Сверхмалая
| Token | Значение |
|---|---|
| Icon button xsmall container height | 32dp |
| Icon button xsmall icon size | 20dp |
| Icon button xsmall narrow leading space | 4dp |
| Icon button xsmall narrow trailing space | 4dp |
| Icon button xsmall default leading space | 6dp |
| Icon button xsmall default trailing space | 6dp |
| Icon button xsmall wide leading space | 10dp |
| Icon button xsmall wide trailing space | 10dp |
| Icon button xsmall container shape round | Circular |
| Icon button xsmall container shape square | 12dp |
| Icon button xsmall outline width | 1dp |
| Icon button xsmall shape pressed morph | 8dp |
| Icon button xsmall shape spring animation damping | 0.9 |
| Icon button xsmall shape spring animation stiffness | 1400 |
| Icon button xsmall selected container shape round | 12dp |
| Icon button xsmall selected container shape square | Circular |
Кнопка со значком — Размер — Малая
| Token | Значение |
|---|---|
| Icon button small container height | 40dp |
| Icon button small icon size | 24dp |
| Icon button small narrow leading space | 4dp |
| Icon button small narrow trailing space | 4dp |
| Icon button small default leading space | 8dp |
| Icon button small default trailing space | 8dp |
| Icon button small wide leading space | 14dp |
| Icon button small wide trailing space | 14dp |
| Icon button small container shape round | Circular |
| Icon button small container shape square | 12dp |
| Icon button small outline width | 1dp |
| Icon button small shape pressed morph | 8dp |
| Icon button small shape spring animation damping | 0.9 |
| Icon button small shape spring animation stiffness | 1400 |
| Icon button small selected container shape round | 12dp |
| Icon button small selected container shape square | Circular |
Кнопка со значком — Размер — Средняя
| Token | Значение |
|---|---|
| Icon button medium container height | 56dp |
| Icon button medium icon size | 24dp |
| Icon button medium narrow leading space | 12dp |
| Icon button medium narrow trailing space | 12dp |
| Icon button medium default leading space | 16dp |
| Icon button medium default trailing space | 16dp |
| Icon button medium wide leading space | 24dp |
| Icon button medium wide trailing space | 24dp |
| Icon button medium container shape round | Circular |
| Icon button medium container shape square | 16dp |
| Icon button medium outline width | 1dp |
| Icon button medium shape pressed morph | 12dp |
| Icon button medium shape spring animation damping | 0.9 |
| Icon button medium shape spring animation stiffness | 1400 |
| Icon button medium selected container shape round | 16dp |
| Icon button medium selected container shape square | Circular |
Кнопка со значком — Размер — Большая
| Token | Значение |
|---|---|
| Icon button large container height | 96dp |
| Icon button large icon size | 32dp |
| Icon button large narrow leading space | 16dp |
| Icon button large narrow trailing space | 16dp |
| Icon button large default leading space | 32dp |
| Icon button large default trailing space | 32dp |
| Icon button large wide leading space | 48dp |
| Icon button large wide trailing space | 48dp |
| Icon button large container shape round | Circular |
| Icon button large container shape square | 28dp |
| Icon button large outline width | 2dp |
| Icon button large shape pressed morph | 16dp |
| Icon button large shape spring animation damping | 0.9 |
| Icon button large shape spring animation stiffness | 1400 |
| Icon button large selected container shape round | 28dp |
| Icon button large selected container shape square | Circular |
Кнопка со значком — Размер — Сверхбольшая
| Token | Значение |
|---|---|
| Icon button xlarge container height | 136dp |
| Icon button xlarge icon size | 40dp |
| Icon button xlarge narrow leading space | 32dp |
| Icon button xlarge narrow trailing space | 32dp |
| Icon button xlarge default leading space | 48dp |
| Icon button xlarge default trailing space | 48dp |
| Icon button xlarge wide leading space | 72dp |
| Icon button xlarge wide trailing space | 72dp |
| Icon button xlarge container shape round | Circular |
| Icon button xlarge container shape square | 28dp |
| Icon button xlarge outline width | 3dp |
| Icon button xlarge shape pressed morph | 16dp |
| Icon button xlarge shape spring animation damping | 0.9 |
| Icon button xlarge shape spring animation stiffness | 1400 |
| Icon button xlarge selected container shape round | 28dp |
| Icon button xlarge selected container shape square | Circular |
Анатомия

- Значок
- Контейнер
Цвет
Цветовые значения задаются с помощью дизайн-токеновДизайн-токены лежат в основе всех элементов интерфейса. Одни и те же токены используются в дизайне, инструментах и коде.Подробнее о дизайн-токенах. Для дизайнеров это означает работу с цветовыми значениями, соответствующими токенам; в коде цветовое значение представлено токеном, который ссылается на конкретное значение.
Предусмотрено четыре встроенных цветовых стиля: заполненный, тональный, контурный и стандартный. Для каждого стиля обычные и переключаемые кнопки используют разные цветовые роли.
TIP
Эти цветовые роли выбраны для обеспечения согласованности и узнаваемости дизайна. Можно использовать другие цветовые роли, если контейнер и текст имеют контрастность не ниже 3:1. Например, роли tertiary и on tertiary.

A: Заполненный, B: Тональный, C: Контурный, D: Стандартный
- По умолчанию
- Переключаемая, не выбрана
- Переключаемая, выбрана
| 1. По умолчанию | 2. Переключаемая, не выбрана | 3. Переключаемая, выбрана | |
|---|---|---|---|
| Заполненный контейнер Заполненный значок | Primary On primary | Surface container On surface variant | Primary On primary |
| Тональный контейнер Тональный значок | Secondary container On secondary container | Secondary container On secondary container | Secondary On secondary |
| Контурный контейнер Контурный значок | Outline variant (outline) On surface variant | Outline variant (outline) On surface variant | Inverse surface Inverse on surface |
| Стандартный значок | On surface variant | On surface variant | Primary |
Состояния
СостоянияСостояния показывают статус взаимодействия компонента или элемента интерфейса.Подробнее о состояниях — это визуальные индикаторы статуса компонента или интерактивного элемента. Слои состояний немного изменяют цвет кнопки. Недоступные состояния используют другие базовые цвета. Подробности см. в описании токеновСостояния заполненной кнопки со значком
По умолчанию

- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Кнопка-переключатель

A: Не выбрана. B: Выбрана
- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Состояния тональной кнопки со значком
По умолчанию

- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Кнопка-переключатель

A: Не выбрана. B: Выбрана
- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Состояния контурной кнопки со значком
По умолчанию

- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Кнопка-переключатель

A: Не выбрана. B: Выбрана
- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Состояния стандартной кнопки со значком
Контейнер стандартной кнопки со значком не виден в состоянии покоя, но появляется при наложении слоя состояния.
По умолчанию

- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Кнопка-переключатель

A: Не выбрана. B: Выбрана
- Доступна
- Недоступна (слой состояния с непрозрачностью 10%)
- При наведении курсора (слой состояния с непрозрачностью 8%)
- В фокусе (слой состояния с непрозрачностью 10%)
- В нажатом состоянии (слой состояния с непрозрачностью 10%)
Морфинг формы
Нажатое состояние
В нажатом состоянии кнопки со значком могут изменять форму, принимая более квадратную форму.
В нажатом состоянии круглые и квадратные кнопки со значком должны иметь одинаковый радиус скругления углов.
Радиус скругления углов зависит от размера кнопки. См. полные значения радиуса скругления углов кнопок со значком

A. Круглая, B. Квадратная
- Доступна
- При наведении курсора
- В нажатом состоянии
В выбранном состоянии
Кроме изменения формы при нажатии, переключаемые кнопки со значком по умолчанию меняют форму в состоянии покоя: с круглой (не выбрана) на квадратную (выбрана).
Если форма в состоянии покоя квадратная, выбранная форма должна быть круглой.

A. Круглая, B. Квадратная
- Доступна
- При наведении курсора
- В нажатом состоянии
- Выбрана
Размеры

A. Сверхмалый B. Малый C. Средний D. Большой E. Сверхбольшой
- Размер значка
- Ширина по умолчанию
- Узкий вариант ширины
- Широкий вариант ширины
Размеры области касания
Для сверхмалых и малых кнопок со значком область касания должна быть не меньше 48 × 48 dp, чтобы соответствовать требованиям доступности.

A. Сверхмалый размер кнопки со значком B. Малый размер кнопки со значком
- Узкий вариант ширины
- Ширина по умолчанию
- Широкий вариант ширины
Радиус скругления углов кнопки

| XS | S | M | L | XL | |
|---|---|---|---|---|---|
| A. Круглая кнопка | Полное скругление | Полное скругление | Полное скругление | Полное скругление | Полное скругление |
| B. Квадратная кнопка | 12dp | 12dp | 16dp | 28dp | 28dp |
| C. Нажатое состояние | 8dp | 8dp | 12dp | 16dp | 16dp |
Базовые токены
Используйте меню таблицы, чтобы выбрать набор токенов. Наборы токенов для заполненных, тональных и контурных кнопок со значком объявлены устаревшими; вместо них используйте новые наборы токенов. Все остальные токены по-прежнему доступны в модуле в верхней части страницы.