Дизайн-токены: обзор
Дизайн-токены лежат в основе всех элементов интерфейса. Одни и те же токены используются в дизайне, инструментах и коде.
- Токены содержат ссылки на значения стилей, например цвета, шрифты и размеры
- Используйте дизайн-токены вместо жёстко заданных значений
- Имя каждого токена отражает способ или место его применения (например, md.comp.fab.primary.container.color задаёт цвет контейнера для FAB)
- Даже если конечное значение токена меняется, его имя и назначение остаются прежними
- В Material Design есть три класса токенов: референсные, системные и компонентные

Ресурсы
| Тип | Ссылка | Статус |
|---|---|---|
| Дизайн | Design Kit (Figma) | Доступно |
| Плагин Material Theme Builder для Figma | Доступно | |
| Реализация | Базовая тема и токены Material (DSP) | Доступно |
Что такое дизайн-токен?
Дизайн-токены — это небольшие многократно используемые дизайнерские решения, формирующие визуальный стиль дизайн-системы. Они заменяют статические значения понятными именами.
Дизайн-токен состоит из двух элементов:
- Имя в формате, принятом в коде, например md.ref.palette.secondary90
- Связанное значение, например #E8DEF8
Значением токена может быть цвет, гарнитура, размер или даже другой токен.

Дизайн-токены устанавливают осмысленную связь между стилевыми решениями, которые иначе не были бы явно связаны.
Например, если в макетах дизайнера и в коде разработчика используется один и тот же токен для «цвета вторичного контейнера», можно быть уверенным, что в обоих местах применяется один и тот же цвет. Это остаётся верным, даже если hex-значение, назначенное этому токену, обновится.

Почему дизайн-токены важны?
Дизайн-токены обеспечивают дизайн-систему единым источником достоверной информации — репозиторием, в котором фиксируются стилевые решения и отслеживаются изменения.
Поскольку токены можно повторно использовать и каждый из них имеет конкретное назначение, они позволяют определять обновления тем и контекстов в масштабе системы. Например, с помощью токенов можно систематически применять высококонтрастную цветовую палитру для улучшения видимости или изменять типографическую шкалу, чтобы текст оставался разборчивым на экране телевизора.
Используя токены в дизайне и реализации, можно обеспечить согласованное распространение обновлений стилей на весь продукт или линейку продуктов. Они также помогают дизайнерам и инженерам «говорить на одном языке», снижая путаницу при передаче макетов из дизайна в разработку.

Как понять, подходят ли вам дизайн-токены
Токены будут наиболее полезны, если:
- Вы планируете обновить дизайн продукта или создаёте продукт с нуля
- Ваша дизайн-система применяется к линейке продуктов или платформ
- Вы хотите упростить поддержку или обновление стилей в будущем
- Вы хотите максимально использовать возможности Material Design, включая такие функции, как динамический цвет
Токены будут менее полезны, если:
- У вас есть существующее приложение с жёстко заданными значениями, которое вряд ли изменится в ближайшие год или два
- В вашем продукте нет дизайн-системы
Дизайн-токены и Material Design
Раньше стили Material описывались в руководствах, файлах дизайна, инструментах и библиотеках компонентов для конкретных платформ.
Теперь благодаря дизайн-токенам можно скачивать, настраивать и применять стили Material, а также интегрировать их в процесс дизайна и разработки.
Токены позволяют документировать решения в независимом от платформы формате, пригодном для совместного использования.

На этом сайте токены представлены в интерактивных модулях.
Эти модули позволяют быстро просмотреть базовые значения цвета, шрифта, размера шрифта, толщины шрифта и т. д., которые хранятся в токенах. Они также показывают связь между ролью, её системным токеном, референсным токеном и предустановленным значением.

Токены также отображаются на вкладках спецификаций в статьях о компонентах.
Сначала токены группируются по состоянию (активное, отключённое, при наведении и т. д.), а затем по элементу — части компонента, к которой применяется токен или значение, например контейнер или текст метки.
Столбцы таблицы:
- Название — аспект стиля компонента, к которому применяется токен, например цвет или шрифт
- Идентификатор токена — токен, определяющий аспект стиля компонента
- Описание — дополнительная информация
- Контекст/значение — значение, которое токен принимает в данном контексте

Как использовать модули токенов
Допустим, нужно проверить цветовую роль для текста метки кнопки с заливкой.
Перейдите в раздел «Обычные кнопки» > «Спецификации», найдите модуль токенов для кнопок с заливкой и среди элементов найдите токены для текста метки.
Скопируйте цветовой токен и вставьте его в код или сравните с цветовой ролью в Figma.

Части имени токена
Части имени токена разделены точками и идут от наиболее общей информации («md») к наиболее конкретной («on-secondary»).
- Все имена токенов в дизайн-системе начинаются с имени системы (например, «md» для Material Design)
- Далее указывается сокращение класса токена: «ref» для референсных, «sys» для системных и «comp» для компонентных токенов
- Имя токена завершается описательными словами, передающими его роль

- Указывает на дизайн-систему
- Указывает на класс токена
- Указывает на назначение токена
Классы токенов
В Material есть три класса токенов:
- Референсные токены
Все доступные токены со связанными значениями. - Системные токены
Решения и роли, определяющие облик дизайн-системы — от цвета и типографики до возвышения и формы. - Компонентные токены
Параметры оформления, назначенные элементам компонента, например цвет значка кнопки.
Благодаря трём классам токенов команды могут обновлять дизайнерские решения глобально или применять изменения к отдельному компоненту.

Референсные токены
Эти токены охватывают все параметры стиля, доступные в дизайн-системе.
Обычно они указывают на статическое значение — например, hex-код цвета или размер шрифта — но также могут указывать на другие референсные токены. Референсные токены не меняются в зависимости от контекста.
Предоставляя список параметров, референсные токены дают команде отправную точку в виде утверждённых цветов, типографики, размеров и т. д.
Все референсные токены начинаются с префикса ref.

Системные токены
Это решения, которые систематизируют язык дизайна для конкретной темы или контекста.
Системные токены определяют назначение, которое референсный токен выполняет в интерфейсе.
Именно на этом уровне задаются темы. Системный токен может указывать на разные референсные токены в зависимости от контекста, например светлой или тёмной темы.
По возможности системные токены должны указывать на референсные токены, а не на статические значения.
Все системные токены начинаются с префикса sys.

Компонентные токены (в разработке)
Они описывают элементы, необходимые для создания компонента, например контейнеры, текст метки, значки и состояния, а также их значения — размер, форму, цвет или возвышение.
По возможности компонентные токены должны указывать на системный или референсный токен, а не содержать жёстко заданные значения, такие как hex-коды.
Не каждое стилевое решение для компонента можно выразить токеном, но если дизайнерское решение применяется к нескольким компонентам со схожим назначением, следует использовать токен.
Все компонентные токены начинаются с префикса comp.

Контексты
Токены могут указывать на разные значения в зависимости от набора условий. Эти условия называются контекстами, а полученные значения — контекстными значениями.
Примеры контекстов: форм-факторы устройств, тёмная тема, плотная компоновка и письменность справа налево.
Контекст можно представить как своего рода тег. Если значение токена помечено тегом «тёмная тема», оно переопределяет значение по умолчанию для этого токена в тёмной теме.
