Образование

Почему дизайн без токенов — это хаос: порядок в стилях за 1 день

Гайды
Набор токенов: цвета, типографика, отступы и скругления
Если в макетах «почти одинаковые» синие, разные отступы и непредсказуемые тени — вам нужны дизайн‑токены. Дизайн‑токены — это переменные, которые описывают визуальные параметры интерфейса (цвета, типографику, отступы, радиусы, тени) и помогают держать систему консистентной в дизайне и в коде.

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

Набор токенов: цвета, типографика, отступы и скругления
Дизайн‑токены — это «имя + значение»: например, color-primary = #1A73E8, где имя несёт смысл, а значение можно менять централизованно. Суть в том, что вы перестаёте копировать конкретные HEX/px по слоям и вместо этого переиспользуете одни и те же сущности во всём продукте.

Сам термин появился в Salesforce в середине 2010-х: команде Lightning Design System нужно было, чтобы одни и те же цвета и отступы одинаково работали на вебе, iOS и Android. Токены стали общим языком между дизайнерами и разработчиками.
Что обычно становится токенами:
  • Цвета: брендовые, фоновые, текстовые, границы, статусы (success/error).
  • Типографика: размер, межстрочный, начертания, текстовые роли (body/caption/heading). Как подобрать сам шрифт — в статье как выбрать шрифт для интерфейса.
  • Spacing: отступы, gaps, сетка.
  • Radius/Shadow/Elevation: скругления, тени и «глубина».

Три уровня токенов

Три уровня токенов: базовые элементы, семантические символы, UI-компоненты
В практике часто выделяют 3 уровня: базовые, семантические и контекстуальные — это помогает масштабировать систему и изолировать изменения.
  • Базовые (base): «чистые» значения без смысла применения (например, конкретные оттенки/шаги размеров).
  • Семантические (semantic): значения со смыслом роли, например color-primary, которые можно перекинуть на другой оттенок без массовой ручной замены.
  • Контекстуальные (contextual): параметры для конкретных компонентов/состояний, которые обычно ссылаются на базовые/семантические, чтобы не плодить хаос.
Мини‑пример иерархии (логика, а не стандарт):
  • base.blue.500 → semantic.color.action.primary → component.button.primary.bg.default / hover.

Нейминг: как назвать токены

Схема нейминга токенов category–property–modifier с примерами
Универсального стандарта нейминга нет, поэтому важнее выбрать понятную структуру и быть последовательным. Практичная схема — category–property–modifier (категория–свойство–модификатор), например: $color-background-hover или $font-size-heading-large.
Правила, которые реально экономят время:
  • Пишите описательно, но коротко: имя должно читаться без «легенды» и поиском находиться быстро.
  • Держите одну структуру на весь проект, иначе токены превращаются во второй хаос.
  • Не привязывайтесь к значению в названии (например, font-size-24px), чтобы изменения не ломали смысл имён.
  • Добавляйте контекст, если есть риск неоднозначности (например, color-button-primary-hover, а не просто color-hover).

Как внедрить в проект (Figma → код)

Токены особенно полезны, когда нужно поддерживать несколько тем (например, light/dark) и синхронизировать дизайн с разработкой как «единый источник правды».

В Figma токены ведут через Variables. Переменная хранит одно значение, может ссылаться на другую переменную и иметь несколько режимов (modes) — например, светлую и тёмную тему. Стили (Styles) хранят готовый набор свойств, поэтому для токенов удобнее переменные.

В коде токены живут в JSON-файлах и CSS-переменных. Для JSON есть общий формат: в октябре 2025 года Design Tokens Community Group при W3C выпустила первую стабильную версию спецификации — Design Tokens Format Module 2025.10. Вот как выглядит пара «базовый → семантический» токен:
tokens.json — формат DTCG 2025.10
{
  "color": {
    "blue": {
      "500": {
        "$type": "color",
        "$value": {
          "colorSpace": "srgb",
          "components": [0.102, 0.451, 0.910],
          "hex": "#1a73e8"
        }
      }
    },
    "action": {
      "primary": {
        "$type": "color",
        "$value": "{color.blue.500}"
      }
    }
  }
}
tokens.css — то же в CSS-переменных
:root {
  --color-blue-500: #1a73e8;
  --color-action-primary: var(--color-blue-500);
}
[data-theme="dark"] {
  --color-action-primary: #8ab4f8;
}
.button-primary {
  background: var(--color-action-primary);
}
Кнопка ссылается только на семантический токен. Чтобы сменить фирменный цвет или добавить тёмную тему, меняют значение токена, а не каждую кнопку.

План на один день (для небольшого продукта):
  1. Аудит: соберите из макетов все цвета, размеры шрифтов, отступы и радиусы. «Почти одинаковые» значения объедините.
  2. Базовые токены: палитра, шкала отступов (например, 4, 8, 12, 16, 24, 32), размеры шрифтов, радиусы — в отдельную коллекцию Variables.
  3. Семантические токены: вторая коллекция с режимами Light и Dark, значения — ссылки на базовые.
  4. Привязка: замените «сырые» HEX и px в кнопках, карточках и полях ввода на переменные.
  5. Словарь и правила: что такое primary, surface, feedback; когда заводить компонентный токен, а когда хватит семантического. Передайте разработчикам JSON или CSS-переменные.
Тип токена Пример Для чего
Base (базовый) color.blue.500 Конкретное значение, без смысла
Semantic (семантический) color.action.primary Роль в интерфейсе
Component (компонентный) button.primary.bg.default Конкретный элемент
Typography font.size.heading.large Типографика
Spacing spacing.4 = 16px Отступы/паддинги
Radius radius.button.small Скругления

Типичные ошибки при внедрении токенов

  • Компоненты ссылаются на базовые токены напрямую. Кнопка берёт blue.500 вместо action.primary — и при смене бренда или теме придётся снова искать все синие.
  • Компонентный токен на каждое свойство. Если у каждой кнопки и карточки свои токены, система разрастается до сотен имён. Начните с семантики и заводите компонентные только там, где они правда отличаются.
  • Значение в имени. font-size-24px перестаёт быть правдой после первой правки.
  • Нет владельца и документации. Без словаря и правил каждый заводит токены по-своему, и через месяц хаос возвращается.
Частые вопросы о дизайн-токенах
  • Что такое дизайн-токены простыми словами?

    Дизайн-токены — это переменные с именем и значением для цветов, типографики, отступов, радиусов и теней. Вместо того чтобы вписывать #1A73E8 в каждый слой, вы используете токен color-primary и меняете значение в одном месте. Как токены выстраиваются в иерархию — в разделе «Три уровня токенов».

  • Чем дизайн-токены отличаются от стилей в Figma?

    Стиль (Style) хранит готовый набор свойств, например текстовый стиль или заливку. Переменная (Variable) хранит одно значение, может ссылаться на другую переменную и переключаться по режимам, например между светлой и тёмной темой. Поэтому токены в Figma удобнее вести в Variables.

  • С какого инструмента начать внедрять токены?

    С Variables в Figma: заведите базовые цвета, шкалу отступов и радиусы, а поверх них — семантический слой. Для передачи в код токены выгружают в JSON или CSS-переменные; пошаговый план — в разделе «Как внедрить в проект». Если вы только осваиваете Figma, начните с гайда Figma с нуля.

  • Есть ли стандартный формат файлов дизайн-токенов?

    Есть общий формат от Design Tokens Community Group при W3C: первая стабильная версия спецификации Design Tokens Format Module 2025.10 вышла 28 октября 2025 года. Это отчёт сообщества, а не официальный стандарт W3C. Файлы токенов в нём — JSON с полями $type и $value.

  • Обязательны ли токены в небольшом проекте?

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

Источники
Design Tokens Community Group (W3C): Design Tokens Format Module 2025.10, Final Community Group Report, 28.10.2025.
Figma Help Center: Guide to variables in Figma (проверено 22.11.2026).
Made on
Tilda