Other
Типы токенов группы Other: Grid, Boolean, String, Template, Composition, Custom. Формы значений, что попадает в Figma и как эти токены применяются.
$type | Экспортируется как | Значение |
|---|---|---|
grid | Стиль Grid | Один объект сетки или массив сеток |
boolean | Переменная Boolean | true или false |
text | Переменная String | Любая строка |
template | Внутренний | Набор стилей для Apply Template |
composition | Внутренний | Описание компонента, см. Composition |
custom | Внутренний или по форме значения | Любой JSON |
Grid
Сетки макета для фреймов. Экспортируются в стиль Grid переключателем Styles → Grid. Значение — один объект или массив сеток.
| Ключ | Значения |
|---|---|
pattern | columns, rows, grid, строчными буквами |
count | Число колонок или строк для columns и rows |
sectionSize | Размер ячейки или дорожки |
gutterSize | Промежуток |
alignment | MIN, MAX, CENTER, STRETCH |
offset | Смещение от края |
color | Цвет сетки CSS-строкой; без ключа остаётся красный Figma |
visible | true или false |
Числовые поля могут быть ссылками на числовые токены, тогда в стиле они привязываются к переменным. При выравнивании STRETCH размер дорожки не используется, при CENTER не используется смещение. Форма редактирования сетки показывает те же поля вместе с цветом и видимостью.
{
"grid": {
"$type": "grid",
"desktop": {
"$value": { "pattern": "columns", "count": 12, "gutterSize": "{spacing.lg}", "alignment": "STRETCH", "offset": 0 }
},
"editor": {
"$value": [
{ "pattern": "columns", "count": 12, "gutterSize": 24, "alignment": "STRETCH" },
{ "pattern": "rows", "sectionSize": 8, "gutterSize": 8, "alignment": "MIN" }
]
}
}
}
Форма Create Grid содержит поля Pattern, Count, Section Size, Gutter, Offset и Alignment. При Apply к фрейму плагин применяет экспортированный стиль сетки, если он есть, иначе задаёт сетку напрямую. Сетки применяются только к фреймам.
Boolean
Переменная Boolean. У таких переменных в Figma нет scopes, поэтому в форме токена этой секции нет.
| Принимается | Результат |
|---|---|
true, false | как есть |
"true", "false" строкой, в любом регистре | true, false |
"enable", "disable" | true, false |
| Ссылка | значение целевого токена |
При Apply булев токен переключает видимость слоя.
{ "flags": { "$type": "boolean", "compact": { "$value": false }, "beta": { "$value": true } } }
String
Строковые константы: подписи, коды валют, названия. Переменная String со всеми scopes. Форма Create String принимает многострочный текст. При Apply строка записывается в текстовый слой.
{ "label": { "$type": "text", "cta": { "$value": "Get started" }, "currency": { "$value": "USD" } } }
Template
Набор стилей для команды Apply Template: в Figma не экспортируется, применяется к слоям напрямую. Две формы записи.
Токен со стилями в $value:
{
"template": {
"$type": "template",
"card-default": {
"$value": {
"direction": "column",
"widthType": "fill",
"padding": "16 16",
"gap": 8,
"borderRadius": 12,
"background": "{color.surface.base}",
"boxShadow": "{shadow.card}"
}
}
}
}
Файл-шаблон с именем и вариантами:
{
"$type": "template",
"name": "Card",
"styles": {
"default": { "direction": "column", "padding": "16 16", "borderRadius": 12, "background": "{color.surface.base}" },
"compact": { "direction": "column", "padding": "12 12", "borderRadius": 10, "background": "{color.surface.base}" }
}
}
Ключи стилей те же, что в styles композиции. Часто используемые:
| Группа | Ключи |
|---|---|
| Раскладка | direction, justifyContent, alignItems, alignContent, flexWrap, gap, wrapGap, padding, paddingHorizontal, paddingVertical |
| Размер | widthType, heightType, width, height, minWidth, maxWidth, minHeight, maxHeight |
| Положение | position, x, y, rotation |
| Фон и цвет | background, fill, color |
| Границы | border, borderColor, borderWidth, borderRadius, borderAlign, cornerSmooth |
| Эффекты | boxShadow, effects, backgroundBlur, layerBlur, glass, opacity |
| Текст | typography, fontFamily, fontWeight, fontSize, lineHeight, letterSpacing, textCase, textDecoration, verticalTrim |
Форма Create Template предлагает список свойств и кнопку Add property; у шаблонов нет scopes и ссылок на другие шаблоны. Полный справочник значений на странице Composition.
Composition
composition описывает компонент Figma в JSON: структуру, свойства, стили и варианты. У него отдельный справочник: Composition.
{ "$type": "composition", "name": "WButton", "structure": { "tag": "FRAME", "class": "root" }, "styles": { ".root": {} } }
Custom
custom, как и любой незнакомый $type, например "baseUnit", хранит любой JSON и остаётся редактируемым. В форме Create custom есть поле Type для декларируемого типа и поле Value с JSON.
{ "meta": { "$type": "custom", "gridUnit": { "$value": 4 }, "config": { "$value": { "spacingScale": 1.5 } } } }
При экспорте плагин смотрит на форму значения: строка становится переменной String, число или математика переменной Number, true/false переменной Boolean, цвет переменной Color, четыре числа кривой Easing, а объект, похожий на типографику, градиент, тень, сетку, размытие или заливку, соответствующим стилем. Значение, которое не похоже ни на один тип, остаётся в JSON, и результат экспорта сообщит, что токен сохранён как custom и не экспортирован.