Kalka
Документация

Компоненты и переменные

Переиспользуемые компоненты с вариантами и свойствами, страница «Переменные» с коллекциями и режимами и то, как переменные становятся пользовательскими свойствами CSS и дизайн-токенами.

docs / components-variables

Компоненты

Компонент — это элемент дизайна, который вы используете повторно: кнопка, карточка, навигационная панель. Его копии, экземпляры, следуют за ним. Измените компонент — и изменится каждый экземпляр, кроме того, что экземпляр переопределяет.

  • Создать компонент: выделите слои и нажмите Cmd Alt K (Ctrl Alt K).
  • Создать экземпляр: перетащите компонент из панели Ассеты на холст или используйте там Вставить экземпляр.
  • Перейти к главному компоненту переносит от экземпляра к его компоненту.
  • Отвязать экземпляр (Cmd Alt B, Ctrl Alt B) превращает экземпляр обратно в обычные слои.

Панель Ассеты показывает компоненты документа сеткой или списком, с поиском.

Варианты

Варианты — это версии одного компонента, например основная или второстепенная кнопка, маленькая или большая. Выделите несколько компонентов и выберите Создать набор компонентов (Shift Cmd K, Ctrl Shift K), затем добавьте свойства вариантов и их значения. У каждого варианта должна быть своя комбинация значений. На экземпляре варианты переключаются в панели «Дизайн».

Свойства компонента

Кроме вариантов, компонент может открывать:

  • свойства типа Текст, чтобы менять подпись в каждом экземпляре;
  • свойства типа Логическое, чтобы показывать или скрывать часть;
  • свойства типа Замена экземпляра, чтобы подменять вложенный компонент, например иконку;
  • слоты — области, где у каждого экземпляра свои слои, с ограничением их количества.

Создайте свойство командой Создать свойство… в панели «Дизайн» или из поля через Применить свойство компонента. У экземпляров эти свойства показаны наверху панели «Дизайн».

Поведение

Компонент может работать как настоящий элемент управления: переключатель, флажок, ползунок, вкладки, текстовое поле, аккордеон, кнопка с состояниями наведения, нажатия, фокуса и отключения и многое другое. Выберите это в разделе Поведение компонента. Тогда Вид › Просмотр (Cmd Alt Enter) запускает элементы управления по-настоящему: можно печатать в текстовом поле, тянуть ползунок, раскрывать аккордеон, в том числе с клавиатуры. Пока вы пробуете, документ не меняется; Esc возвращает к редактированию.

Библиотеки

Чтобы использовать компоненты в разных документах, опубликуйте документ как библиотеку командой Опубликовать библиотеку, а затем включите её в другом документе через Управление библиотеками. Когда библиотека меняется, Проверить обновления библиотеки показывает, что изменилось, рядом или наложением, до того как вы обновитесь.

Переменные

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

Как открыть страницу «Переменные»

Нажмите Переменные в левой колонке. В десктопном редакторе страница «Переменные» открывается поверх панелей и холста. Нажмите Переменные ещё раз, выберите другую панель или нажмите Esc, чтобы вернуть холст в прежнем виде. Открыть её можно также через Вид › Переменные… или кнопкой Открыть переменные в панели «Дизайн», когда ничего не выделено. На экране телефона она открывается как диалог.

Страница «Переменные» с коллекцией Tokens: переменные цветов, отступов и радиусов со значениями Light и Dark, их CSS-имена и сгенерированная таблица стилей ниже
Страница «Переменные»: каждая переменная с CSS-именем и значением для каждого режима, а также таблица стилей, которую пишет Kalka.

Типы

Тип Для чего
Цвет заливки, обводки, цвета теней
Число размеры, отступы, радиусы, непрозрачность, размеры шрифта
Текст подписи, тексты, гарнитуры
Логический истина или ложь, например видимость слоя

Переменную можно ограничить некоторыми полями с помощью её областей применения, чтобы отступ никогда не появлялся в списке цветов. Её Выражение CSS позволяет хранить в коде что-то вроде clamp(1rem, 4vw, 1.5rem).

Коллекции и режимы

Переменные живут в коллекциях, например «Цвета» или «Отступы», и их можно раскладывать по группам. У коллекции могут быть режимы: светлый и тёмный, компактный и просторный, по одному на бренд. У каждой переменной есть значение для каждого режима.

Каждый режим указывает, когда он действует в экспортированном CSS:

  • переключается вручную атрибутом, например data-theme;
  • когда система в тёмном или светлом режиме;
  • при высоком контрасте или уменьшении движения;
  • ниже или выше ширины экрана или контейнера;
  • или под любым CSS-селектором или запросом @media, @supports или @container, который вы напишете.

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

Рядом с полем нажмите Использовать переменную и выберите её в небольшом списке; при наведении на переменную цвета или числовую переменную холст показывает предпросмотр. Отвязать переменную возвращает обычное значение. Из уже заданного значения Создать переменную цвета или Создать числовую переменную делают переменную в один шаг.

Переменные в коде

Переменные — это пользовательские свойства CSS. Режим по умолчанию каждой коллекции записывается в :root, а остальные режимы переопределяют только отличающиеся значения, при своём условии. Переменная Gray/50 становится --color-gray-50, а Space/small — --spacing-small; можно задать собственное CSS-имя.

Со страницы «Переменные» можно:

  • Копировать все переменные как CSS или как тему Tailwind (@theme);
  • Экспортировать как дизайн-токены: .zip с дизайн-токенами W3C, по одному файлу на режим коллекции;
  • Импортировать дизайн-токены из файлов .json, .tokens или .zip. Переменные с тем же именем обновляются; ничего не удаляется.

В папке Kalka переменные сохраняются как дизайн-токены W3C в design-system/tokens.json и как CSS в design-system/tokens.css. См. Файлы и версии.