Дизайн-токены — это именованные значения визуальных свойств интерфейса: цветов, размеров шрифта, отступов, скруглений, теней. Вместо числа «#2563EB» в макете и коде используется имя, например color-primary, и оно ссылается на конкретное значение.
Термин пришёл из дизайн-системы Salesforce Lightning. Смысл простой: значение хранится в одном месте, а все компоненты берут его по имени. Нужно поменять фирменный синий — меняете один токен, и обновляются кнопки, ссылки и значки на всех страницах. Токены также позволяют синхронизировать дизайн и код: дизайнер и разработчик говорят про одни и те же имена.
Хранят токены обычно в формате JSON или в переменных Figma, а в коде они превращаются в CSS-переменные, переменные Sass или константы для приложений. Это позволяет собрать из одного источника сайт, мобильное приложение и документацию.
Уровни токенов
- Базовые (глобальные): сырые значения вроде blue-500 или space-4. Они описывают палитру и шкалу.
- Семантические: роль значения, например text-primary, bg-surface, border-error. Они ссылаются на базовые.
- Компонентные: значения для конкретного компонента, например button-radius.
Такая цепочка позволяет делать тёмную тему: семантический токен text-primary в светлой теме указывает на тёмно-серый, в тёмной — на почти белый, а компоненты не меняются совсем.
Пример
В CSS это выглядит так: --color-text: #1a1a1a; и --space-4: 16px;. Кнопка использует padding: var(--space-4) и color: var(--color-text). Меняете значение переменной — меняется везде.
Как внедрить
- Выпишите все цвета, размеры и отступы, которые есть в продукте.
- Сведите похожие значения к шкале: например, отступы 4, 8, 16, 24, 32.
- Дайте имена по роли, а не по виду: не «красный», а «ошибка».
- Заведите переменные в Figma и в коде с одинаковыми именами.
- Запретите писать значения вручную в новых компонентах.
Типичные ошибки
- Называть токены по цвету (blue-button): при смене бренда имя перестаёт быть правдой.
- Создавать токен на каждое значение, и система превращается в свалку.
- Хранить токены только в макете, без связи с кодом.
Зачем это бизнесу
Токены ускоряют ребрендинг и запуск новых продуктов. Если цвета и шрифты хранятся в одном источнике, смена фирменного стиля превращается в правку нескольких значений, а не в ручной проход по сотням экранов. Токены также сокращают споры между дизайнерами и разработчиками: оба ссылаются на одно и то же имя и видят одно и то же значение.
Частый вопрос
Чем токены отличаются от обычных CSS-переменных? CSS-переменная — это способ хранить значение в коде. Токен — это идея и договорённость: значение с именем и ролью, которое одинаково живёт в макетах, коде и документации. В вебе токены чаще всего реализуют через CSS-переменные, но токен шире, потому что описывает общий источник правды.