В этой статье
Управление дизайн-системой связывает повторно используемые ресурсы дизайна с именами и решениями, на которых команда строит продукт. В Pixso DSM можно просматривать опубликованные стили, токены и компоненты, задавать псевдонимы, если названия в дизайне и коде различаются, и готовить ресурсы для разработки. Полезный результат — понятное обеим командам соответствие, а не предположение, что любая правка дизайна автоматически меняет работающее приложение.
Если вы создаёте общую библиотеку, инструменты дизайн-системы Pixso предоставляют компоненты и стили, с которыми работает DSM. Начните с одной опубликованной библиотеки и одного характерного компонента. Хороший первый пример — кнопка основного действия: её имя, свойства, цвета и состояния должны означать одно и то же в дизайне и реализации.
Что такое управление дизайн-системой?
DSM позволяет публиковать, просматривать и поддерживать спецификации дизайна. Он помогает дизайнерам и разработчикам договориться, какие ресурсы можно использовать повторно и как их обозначать. При этом команде по-прежнему нужно решить, кто публикует изменения, как их принимают потребители библиотеки и кто поддерживает соответствующий код.
У ресурсов разные задачи:
Стили объединяют повторно используемые визуальные настройки, например параметры текста или эффектов. Стиль должен обозначать понятное коллегам назначение, а не быть очередным безымянным набором значений.

Опубликованные цветовые стили в Pixso DSM.Открыть изображение крупнее Дизайн-токены присваивают значениям дизайна имена, чтобы их можно было обсуждать и использовать повторно. Семантическое имя, например цвет основного действия, лучше объясняет назначение, чем название, описывающее лишь текущий оттенок.

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

Компоненты кнопок и их варианты в DSM.Открыть изображение крупнее
Общий источник спецификаций уменьшает число противоречащих друг другу материалов. Однако библиотека дизайна, сгенерированный результат и код, развёрнутый в продукте, остаются разными сущностями. Свяжите их явным процессом передачи изменений.
Откройте DSM из опубликованной библиотеки
Выберите файл библиотеки, ресурсы которого уже опубликованы. В документации Pixso для разработчиков на английском языке, в разделах D2C⁺ и DSM, описаны три способа входа.
1. Через меню имени файла в редакторе
Откройте библиотеку в режиме дизайна, раскройте меню имени файла и выберите Design system mode — режим дизайн-системы.

2. Через ресурсы команды
На панели команды откройте раздел ресурсов или ассетов, найдите библиотеку и выберите Open in Design System.

3. Через список библиотек в редакторе
Откройте список библиотек, выберите нужную и нажмите Open design system. Перед изменением псевдонимов проверьте название библиотеки, особенно если похожие компоненты поддерживают несколько команд.

Задайте псевдонимы, соответствующие реализации
Псевдонимы задают осознанное соответствие между ресурсами дизайна и именами в коде. Его определяют дизайнеры и разработчики: DSM не выясняет автоматически назначение каждого ресурса. Если имена и свойства уже совпадают с компонентами фронтенда, дополнительные псевдонимы не нужны.
Предположим, компонент в дизайне называется Button / Primary, а в кодовой базе есть ActionButton со свойством intent. Прежде чем вводить псевдонимы, согласуйте следующее соответствие:
| Ресурс дизайна | Согласованное имя в коде | Смысл, который нужно сохранить |
|---|---|---|
| Компонент кнопки | ActionButton | Существующая повторно используемая кнопка, а не новый компонент для каждого экрана |
| Свойство варианта: emphasis | intent | Роль кнопки в интерфейсе |
| Значение варианта: primary | primary | Основное действие в текущей задаче |
| Токен заливки основного действия | actionPrimary | Семантический цвет основных действий |
Эти имена — соглашение команды, а не обязательные идентификаторы Pixso. Используйте названия, принятые в вашем проекте. Отключённая основная кнопка не должна превращаться в отдельное бизнес-действие только из-за другого цвета заливки. Сопоставляйте свойства компонентов и назначение токенов по отдельности, а затем проверяйте вместе.
- Найдите ресурс в DSM. Выберите нужный стиль, токен или компонент и изучите его текущее имя и значения.

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

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

Разделяйте публикацию и применение обновления
Допустим, команда меняет цвет основного действия и переименовывает его псевдоним. Владелец библиотеки должен указать оба изменения в примечаниях к выпуску. При принятии обновления дизайнер проверяет затронутые экраны, а разработчик рассматривает соответствующие изменения токена или компонента в кодовой базе. Публикация библиотеки не равнозначна коммиту кода или развёртыванию приложения.
Для небольшого пилота сравните обычную, отключённую и загружающуюся версии одной кнопки. Убедитесь, что подписи, имена свойств и семантические цвета всё ещё соответствуют договорённости. Если изменение нарушает работу существующего потребителя, согласуйте миграцию или восстановите прежний ресурс, прежде чем расширять внедрение.
Используйте код компонента, сохраняя соглашения проекта
После настройки псевдонимов откройте предпросмотр кода характерного компонента. Псевдоним и имена свойств должны отражать соответствие, согласованное с разработчиком. Сравните результат с реальным API компонента: внешне похожие имена не обязательно взаимозаменяемы.


Скопируйте нужный результат в рабочую ветку разработки и проверьте импорты, поддерживаемые свойства, зависимости стилей и поведение. Правильный вид основной кнопки ещё не доказывает, что отправка, отключение или индикатор загрузки работают корректно. За эти действия отвечает реализация приложения.
Когда нужны D2C⁺ и парсеры компонентов
D2C⁺ поддерживает вывод для React, Vue и Flutter. Для работы нужны место Full-feature Seat или Dev Seat в плане Enterprise и файл в корпоративном пространстве. В Dev View выберите D2C⁺, затем дизайн или элемент для генерации кода. Эти условия относятся к D2C⁺: само открытие DSM не предоставляет соответствующие права.
Конфигурация парсера компонентов нужна, если экземпляры дизайна должны сопоставляться с определённой библиотекой компонентов кода. Если такая привязка не требуется, настройка необязательна. Псевдоним идентифицирует ресурс, а парсер может описывать соответствие экземпляра тегу компонента и его свойствам. Прежде чем применять конфигурацию ко многим экранам, проверьте её со специалистом, знакомым с целевой кодовой базой.
Экспортируйте стили и дизайн-токены, затем проверьте изменения
В представлении экспорта стилей и токенов можно выбрать ресурсы и сформировать предпросмотр кода. На скриншотах ниже показан экспорт CSS. Выберите формат и набор ресурсов, которые доступны в панели экспорта и нужны для вашей задачи. Изменение одной группы стилей не требует экспорта всей библиотеки.
- Выберите ресурсы. Отметьте нужные категории и элементы. При изменении цвета основной кнопки определите её токен и выясните, используют ли его другие компоненты.
- Сформируйте и изучите предпросмотр. Проверьте имена, значения и ссылки. Ищите повторяющиеся идентификаторы, отсутствующие зависимости и переименованные значения, на которые приложение всё ещё ссылается по старому имени.

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

Сохраните для команды видимую связь между выпуском библиотеки и изменением реализации. Короткая запись «Обновлён цвет основного действия; псевдоним сохранён; проверены действия кнопок и диалогов» полезнее, чем «дизайн-система синхронизирована». Она объясняет потребителям, что изменилось и что им нужно применить.
Начните с одной кнопки, нескольких семантических токенов и одного экрана, который их использует. Когда имена, публикация и применение кода будут согласованно работать, распространите этот подход на остальную библиотеку.
Откройте Pixso и организуйте библиотеку дизайна своей команды