Skip to content
Material Design 3
Main Navigation
v3
v2
v1

Русский

English
简体中文
繁體中文
Español
Français
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Русский

English
简体中文
繁體中文
Español
Français
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Внешний вид

Sidebar Navigation

Основы

Доступность

Обзор: принципы

Обзор: вспомогательные технологии

Проектирование: обзор

Проектирование: цветовой контраст

Проектирование: структура

Проектирование: сценарии взаимодействия

Проектирование: элементы

Рекомендации по написанию текстов

Работа с текстом: усечение текста

Написание и оформление текста: изменение размера текста

Создание для всех: потребности пользователей

Создание для всех: совместное проектирование

Контент-дизайн

Обзор

Альтернативный текст

Глобальный подход к написанию текстов: обзор

Глобальные правила написания: выбор слов

Уведомления

Руководство по стилю: лучшие практики написания UX-текстов

Руководство по стилю: выбор слов

Руководство по стилю: грамматика и пунктуация

Кастомизация Material

Устройства

Дизайн для часов: обзор

Дизайн для часов: основы

Дизайн для часов: стили

Дизайн для часов: компоновка

XR

Дизайн иммерсивной расширенной реальности (XR): обзор

Дизайн иммерсивной XR: взаимодействие

Дизайн иммерсивного XR: компоновка

Дизайн для иммерсивного XR: доступность

Компоненты XR: обзор

XR-компоненты: панели приложения

XR-компоненты: диалоги

XR-компоненты: панель навигации

XR-компоненты: боковая панель навигации

XR-компоненты: панели инструментов

Дизайн-токены: обзор

Дизайн-токены: использование токенов

Взаимодействие

Жесты

Устройства ввода: основы

Выбор: обзор

Состояния: обзор

Состояния: слои состояния

Состояния: применение состояний

Макет

Обзор макета: общие сведения

Обзор макета: части макета

Обзор макетов: адаптивный дизайн

Scaffold: Обзор

Каркас: бары

Scaffold: рейлы

Каркас: панели

Сетки и отступы: обзор

Сетки и отступы: сетки

Сетки и отступы: отступы

Сетки и отступы: плотность

Обзор контрольных точек

Контрольные точки: компактные

Контрольные точки: средний размер

Контрольные точки: расширенные

Контрольные точки: большие и сверхбольшие

Двунаправленность и RTL

Канонические примеры макетов: обзор

Примеры типовых макетов: лента

Канонические примеры компоновки: список — подробности

Канонические примеры макетов: вспомогательная панель

Удобство использования: обзор

Юзабилити: применение M3 Expressive

Material от A до Я

Стили

Цвет

Цветовая система: обзор

Цветовая система: как устроена система

Цветовые роли

Цветовые схемы

Выбор схемы

Статические цветовые схемы: Baseline

Статические цветовые схемы: собственный бренд

Динамические цветовые схемы: выбор источника

Динамические цветовые схемы: источник, генерируемый пользователем

Динамические цветовые схемы: источник цвета на основе контента

Расширенные настройки: обзор

Расширенные настройки: применение цветов

Расширенная настройка: определение новых цветов

Расширенные настройки: настройка существующих цветов

Цветовые ресурсы

Возвышение: обзор

Возвышение: применение возвышения

Возвышение: токены

Значки: обзор

Значки: создание значков

Значки: применение значков

Движение

Система физики движения: принцип работы

Система физики движения: спецификации

Плавность и длительность: применение плавности и длительности

Плавность и длительность: токены и спецификации

Переходы: шаблоны переходов

Переходы: применение переходов

Форма: обзор и принципы

Форма: шкала радиусов скругления

Форма: морфинг форм

Отступы: обзор

Отступы: применение отступов

Токены отступов

Типографика: обзор

Типографика: шрифты

Типографика: типографическая шкала и токены

Типографика: применение типографики

Типографика: акцентные типографические приемы

Компоненты

Панели приложений: обзор

Панели приложений: спецификации

Панели приложений: рекомендации

Панели приложений: доступность

Бейджи: обзор

Бейджи: спецификации

Бейджи: рекомендации

Бейджи: доступность

Кнопки

Все кнопки

Группы кнопок: обзор

Группы кнопок: спецификации

Группы кнопок: рекомендации

Группы кнопок: доступность

Кнопки: обзор

Кнопки: спецификации

Кнопки: рекомендации

Кнопки: доступность

Расширенные FAB: обзор

Расширенные FAB: спецификации

Расширенные FAB: рекомендации

Расширенные FAB-кнопки: доступность

Меню FAB: обзор

Меню FAB: спецификации

FAB-меню: рекомендации

Доступность меню FAB

Плавающие кнопки действий (FAB): обзор

Плавающие кнопки действия (FAB): спецификации

Плавающие кнопки действий (FAB): рекомендации

Плавающие кнопки действия (FAB): доступность

Кнопки со значками: обзор

Кнопки со значками: спецификации

Кнопки со значками: рекомендации

Кнопки со значками: доступность

Сегментированные кнопки: обзор

Сегментированные кнопки: спецификации

Сегментированные кнопки: рекомендации

Сегментированные кнопки: доступность

Кнопки с раскрывающимися списками: обзор

Кнопки с раскрывающимися списками: спецификации

Кнопки с раскрывающимися списками: рекомендации

Кнопки с раскрывающимися списками: доступность

Карточки: обзор

Карточки: спецификации

Карточки: рекомендации

Карточки: доступность

Карусель: обзор

Карусель: спецификации

Карусель: рекомендации

Карусель: доступность

Флажок: обзор

Флажок: спецификации

Флажок: рекомендации

Флажок: доступность

Чипы: обзор

Чипы: спецификации

Чипы: рекомендации

Чипы: доступность

Выбор даты и времени

Выбор даты: обзор

Средства выбора даты: спецификации

Компоненты выбора даты: рекомендации

Выбор даты: доступность

Средства выбора времени: обзор

Выбор времени: спецификации

Средства выбора времени: рекомендации

Средства выбора времени: доступность

Обзор диалоговых окон

Диалоговые окна: спецификации

Диалоговые окна: рекомендации

Диалоги: доступность

Разделитель: обзор

Разделитель: спецификации

Разделитель: рекомендации

Разделитель: доступность

Списки: обзор

Списки: спецификации

Списки: рекомендации

Списки: доступность

Загрузка и прогресс

Индикатор загрузки: обзор

Индикатор загрузки: спецификации

Индикатор загрузки: рекомендации

Индикатор загрузки: доступность

Индикаторы выполнения: обзор

Индикаторы выполнения: спецификации

Индикаторы выполнения: рекомендации

Индикаторы выполнения: доступность

Меню: обзор

Меню: спецификации

Меню: рекомендации

Меню: доступность

Навигация

Панель навигации: обзор

Панель навигации: спецификации

Панель навигации: рекомендации

Панель навигации: доступность

Боковая боковая панель навигации: обзор

Боковая боковая панель навигации: спецификации

Боковая панель навигации: рекомендации

Боковая панель навигации: доступность

Навигационная рейка: обзор

Навигационная рейка: спецификации

Навигационная рейка: рекомендации

Навигационная рейка: доступность

Радиокнопки: обзор

Радиокнопка: спецификации

Радиокнопки: рекомендации

Радиокнопка: доступность

Поиск: обзор

Поиск: спецификации

Поиск: рекомендации

Поиск: доступность

Панели

Нижние панели: обзор

Нижние панели: спецификации

Нижние панели: рекомендации

Нижние панели: доступность

Боковые панели: обзор

Боковые панели: спецификации

Боковые панели: рекомендации

Боковые панели: доступность

Ползунки: обзор

Ползунки: спецификации

Ползунки: рекомендации

Ползунки: доступность

Снекбар: обзор

Снекбар: спецификации

Снекбар: рекомендации

Снекбар: доступность

Переключатель: обзор

Переключатель: спецификации

Переключатель: рекомендации

Переключатель: доступность

Вкладки: обзор

Вкладки: спецификации

Вкладки: рекомендации

Вкладки: доступность

Текстовые поля: обзор

Текстовые поля: спецификации

Текстовые поля: рекомендации

Текстовые поля: доступность

Панели инструментов: обзор

Панели инструментов: спецификации

Панели инструментов: рекомендации

Панели инструментов: доступность

Всплывающие подсказки: обзор

Всплывающие подсказки: спецификации

Всплывающие подсказки: рекомендации

Всплывающие подсказки: доступность

Содержание страницы

Дизайн-токены: обзор ​

Дизайн-токены лежат в основе всех элементов интерфейса. Одни и те же токены используются в дизайне, инструментах и коде.


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

Ресурсы ​

ТипСсылкаСтатус
ДизайнDesign Kit (Figma)Доступно
Плагин Material Theme Builder для FigmaДоступно
РеализацияБазовая тема и токены Material (DSP)Доступно

Что такое дизайн-токен? ​

Дизайн-токены — это небольшие многократно используемые дизайнерские решения, формирующие визуальный стиль дизайн-системы. Они заменяют статические значения понятными именами.

Дизайн-токен состоит из двух элементов:

  1. Имя в формате, принятом в коде, например md.ref.palette.secondary90
  2. Связанное значение, например #E8DEF8

Значением токена может быть цвет, гарнитура, размер или даже другой токен.

Токен md.ref.palette.secondary90 со стрелкой, указывающей на сиреневый образец цвета #E8DEF8.
Пример референсного токена и его значения цвета

Дизайн-токены устанавливают осмысленную связь между стилевыми решениями, которые иначе не были бы явно связаны.

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

Схема FAB с системными токенами: secondary для цвета поверхности и on secondary для цвета значка
Пример токенов, назначенных ролям цвета secondary и on secondary для контейнера и значка FAB соответственно

Почему дизайн-токены важны? ​

Дизайн-токены обеспечивают дизайн-систему единым источником достоверной информации — репозиторием, в котором фиксируются стилевые решения и отслеживаются изменения.

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

Используя токены в дизайне и реализации, можно обеспечить согласованное распространение обновлений стилей на весь продукт или линейку продуктов. Они также помогают дизайнерам и инженерам «говорить на одном языке», снижая путаницу при передаче макетов из дизайна в разработку.

Схема: изменение значения токена распространяется из дизайн-системы в раздел продукта и в три продукта
По мере развития дизайн-системы некоторые значения будут меняться. С помощью дизайн-токенов можно отслеживать изменения и обеспечивать единообразие оформления всех продуктов.

Как понять, подходят ли вам дизайн-токены ​

Токены будут наиболее полезны, если:

  • Вы планируете обновить дизайн продукта или создаёте продукт с нуля
  • Ваша дизайн-система применяется к линейке продуктов или платформ
  • Вы хотите упростить поддержку или обновление стилей в будущем
  • Вы хотите максимально использовать возможности Material Design, включая такие функции, как динамический цвет

Токены будут менее полезны, если:

  • У вас есть существующее приложение с жёстко заданными значениями, которое вряд ли изменится в ближайшие год или два
  • В вашем продукте нет дизайн-системы

Дизайн-токены и Material Design ​

Раньше стили Material описывались в руководствах, файлах дизайна, инструментах и библиотеках компонентов для конкретных платформ.

Теперь благодаря дизайн-токенам можно скачивать, настраивать и применять стили Material, а также интегрировать их в процесс дизайна и разработки.

Токены позволяют документировать решения в независимом от платформы формате, пригодном для совместного использования.

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

На этом сайте токены представлены в интерактивных модулях.

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

Модуль токенов для цветовой системы с 4 образцами цвета для набора основного цвета.
Пример модуля токенов

Токены также отображаются на вкладках спецификаций в статьях о компонентах.

Сначала токены группируются по состоянию (активное, отключённое, при наведении и т. д.), а затем по элементу — части компонента, к которой применяется токен или значение, например контейнер или текст метки.

Столбцы таблицы:

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

Как использовать модули токенов

Допустим, нужно проверить цветовую роль для текста метки кнопки с заливкой.

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

Скопируйте цветовой токен и вставьте его в код или сравните с цветовой ролью в Figma.

Как найти токен цвета текста метки.
Схема и таблица токенов для цвета метки кнопки с заливкой

Части имени токена ​

Части имени токена разделены точками и идут от наиболее общей информации («md») к наиболее конкретной («on-secondary»).

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

Классы токенов ​

В Material есть три класса токенов:

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

Благодаря трём классам токенов команды могут обновлять дизайнерские решения глобально или применять изменения к отдельному компоненту.

Схема: значение цвета передаётся из референсного токена в системный и компонентный токены и отображается как цвет контейнера FAB
Кнопка получает цвет контейнера через систему из трёх токенов, определяющих масштабируемые значения цвета. Цветовые токены указывают на конкретное hex-значение, которое можно легко изменить, не влияя на синтаксис токена.

Референсные токены

Эти токены охватывают все параметры стиля, доступные в дизайн-системе.

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

Предоставляя список параметров, референсные токены дают команде отправную точку в виде утверждённых цветов, типографики, размеров и т. д.

Все референсные токены начинаются с префикса ref.

Токен md.ref.palette.secondary90, указывающий на #E8DEF8. Токен md.ref.typeface.plain-medium, указывающий на Roboto Medium
Референсные токены цвета и типографики и их значения

Системные токены

Это решения, которые систематизируют язык дизайна для конкретной темы или контекста.

Системные токены определяют назначение, которое референсный токен выполняет в интерфейсе.

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

По возможности системные токены должны указывать на референсные токены, а не на статические значения.

Все системные токены начинаются с префикса sys.

Системный токен md.sys.color.secondary-container, указывающий на токен md.ref.palette.secondary90, который указывает на #E8DEF8. Системный токен md.sys.typescale.label-medium.font, указывающий на токен md.ref.typeface.plain-medium, который указывает на Roboto Medium
Системные токены, референсные токены и их значения

Компонентные токены (в разработке) ​

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

По возможности компонентные токены должны указывать на системный или референсный токен, а не содержать жёстко заданные значения, такие как hex-коды.

Не каждое стилевое решение для компонента можно выразить токеном, но если дизайнерское решение применяется к нескольким компонентам со схожим назначением, следует использовать токен.

Все компонентные токены начинаются с префикса comp.

Компонентные токены расширенной FAB для цвета контейнера и текста метки, указывающие на системные токены, затем на референсные токены, затем на итоговые значения
Компонентные токены, системные токены, референсные токены и их значения

Контексты ​

Токены могут указывать на разные значения в зависимости от набора условий. Эти условия называются контекстами, а полученные значения — контекстными значениями.

Примеры контекстов: форм-факторы устройств, тёмная тема, плотная компоновка и письменность справа налево.

Контекст можно представить как своего рода тег. Если значение токена помечено тегом «тёмная тема», оно переопределяет значение по умолчанию для этого токена в тёмной теме.

Схема: системный токен цвета фона указывает на разные значения в зависимости от контекста темы
Один и тот же системный токен цвета фона может указывать на разные референсные токены в зависимости от контекста: светлая или тёмная тема
Pager
Предыдущая страницаXR-компоненты: панели инструментов
Следующая страницаДизайн-токены: использование токенов

Выпущено на условиях лицензии Apache 2.0 или CC BY 4.0.

Авторские права © 2018-Present Google

https://m3.material.io/foundations/design-tokens/overview

Выпущено на условиях лицензии Apache 2.0 или CC BY 4.0.

Авторские права © 2018-Present Google