---
title: "Компоненты и переменные | Kalka docs"
description: "Переиспользуемые компоненты с вариантами и свойствами, страница «Переменные» с коллекциями и режимами и то, как переменные становятся пользовательскими свойствами CSS и дизайн-токенами."
url: https://kalka.design/ru/docs/components-variables
language: ru
---

## Компоненты

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

- **Создать компонент:** выделите слои и нажмите 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`. См. [Файлы и версии](https://kalka.design/ru/docs/files-versions).
