Tokens

Other

Типы токенов группы Other: Grid, Boolean, String, Template, Composition, Custom. Формы значений, что попадает в Figma и как эти токены применяются.

$typeЭкспортируется какЗначение
gridСтиль GridОдин объект сетки или массив сеток
booleanПеременная Booleantrue или false
textПеременная StringЛюбая строка
templateВнутреннийНабор стилей для Apply Template
compositionВнутреннийОписание компонента, см. Composition
customВнутренний или по форме значенияЛюбой JSON

Grid

Сетки макета для фреймов. Экспортируются в стиль Grid переключателем Styles → Grid. Значение — один объект или массив сеток.

КлючЗначения
patterncolumns, rows, grid, строчными буквами
countЧисло колонок или строк для columns и rows
sectionSizeРазмер ячейки или дорожки
gutterSizeПромежуток
alignmentMIN, MAX, CENTER, STRETCH
offsetСмещение от края
colorЦвет сетки CSS-строкой; без ключа остаётся красный Figma
visibletrue или false

Числовые поля могут быть ссылками на числовые токены, тогда в стиле они привязываются к переменным. При выравнивании STRETCH размер дорожки не используется, при CENTER не используется смещение. Форма редактирования сетки показывает те же поля вместе с цветом и видимостью.

JSON
{
  "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 булев токен переключает видимость слоя.

JSON
{ "flags": { "$type": "boolean", "compact": { "$value": false }, "beta": { "$value": true } } }

String

Строковые константы: подписи, коды валют, названия. Переменная String со всеми scopes. Форма Create String принимает многострочный текст. При Apply строка записывается в текстовый слой.

JSON
{ "label": { "$type": "text", "cta": { "$value": "Get started" }, "currency": { "$value": "USD" } } }

Template

Набор стилей для команды Apply Template: в Figma не экспортируется, применяется к слоям напрямую. Две формы записи.

Токен со стилями в $value:

JSON
{
  "template": {
    "$type": "template",
    "card-default": {
      "$value": {
        "direction": "column",
        "widthType": "fill",
        "padding": "16 16",
        "gap": 8,
        "borderRadius": 12,
        "background": "{color.surface.base}",
        "boxShadow": "{shadow.card}"
      }
    }
  }
}

Файл-шаблон с именем и вариантами:

JSON
{
  "$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.

JSON
{ "$type": "composition", "name": "WButton", "structure": { "tag": "FRAME", "class": "root" }, "styles": { ".root": {} } }

Custom

custom, как и любой незнакомый $type, например "baseUnit", хранит любой JSON и остаётся редактируемым. В форме Create custom есть поле Type для декларируемого типа и поле Value с JSON.

JSON
{ "meta": { "$type": "custom", "gridUnit": { "$value": 4 }, "config": { "$value": { "spacingScale": 1.5 } } } }

При экспорте плагин смотрит на форму значения: строка становится переменной String, число или математика переменной Number, true/false переменной Boolean, цвет переменной Color, четыре числа кривой Easing, а объект, похожий на типографику, градиент, тень, сетку, размытие или заливку, соответствующим стилем. Значение, которое не похоже ни на один тип, остаётся в JSON, и результат экспорта сообщит, что токен сохранён как custom и не экспортирован.

Связанные страницы