Cross-file Sync
Как перенести значения переменных из другого файла Figma: ключ файла, токен Figma, сравнение по коллекциям и применение выбранных изменений.
Cross-file Sync сравнивает переменные текущего файла с переменными другого файла Figma и переносит значения, которых нет или которые отличаются. Это удобно, когда команда ведёт несколько файлов с одинаковыми коллекциями, например библиотеку и проектный файл, и нужно быстро подтянуть обновления без экспорта и импорта JSON.
Вкладка Cross-file: ключ файла-источника, токен Figma и кнопка Compare Variables.
Что нужно
- Ключ файла-источника. Возьмите его из адреса файла:
figma.com/design/КЛЮЧ/…. - Personal Access Token Figma с правом чтения переменных. Создаётся в настройках аккаунта Figma, начинается с
figd_. - Тариф Figma. Чтение переменных другого файла через REST API доступно только в Enterprise. На других тарифах плагин покажет Enterprise Plan Required.
- Доступ к файлу-источнику у владельца токена.
Как перенести переменные
- Нажмите шестерёнку Sync settings в футере и откройте вкладку Cross-file.
- Вставьте ключ файла в Figma File Key и токен в Personal Access Token.
- Нажмите Compare Variables. Плагин загрузит переменные источника и сравнит их с текущим файлом по имени коллекции и имени переменной.
- Просмотрите результат: строка N actionable changes found и список по коллекциям. Каждая переменная помечена как New (в текущем файле её нет), Changed (значение отличается) или Removed (в источнике её нет). Совпадающие переменные не показываются.
- Снимите галочки с коллекций, которые переносить не нужно, и нажмите Sync N variables.
- Плагин сообщит Created: N, Updated: M. Если что-то не удалось применить, ошибки будут перечислены под результатом.
Если различий нет, плагин покажет All variables are in sync. No changes needed.
Что важно знать
- Сравниваются значения первого режима каждой коллекции.
- Если в текущем файле нет коллекции источника, плагин создаст её.
- Переносятся переменные всех типов Figma, включая Timing и Easing.
- Переменные со статусом Removed из текущего файла не удаляются, они только показаны в списке.
- Пока активен Local Workspace в режиме только для чтения, применение изменений заблокировано.
Если что-то не работает
| Сообщение | Что делать |
|---|---|
| Enterprise Plan Required | REST API переменных недоступен на вашем тарифе Figma. Используйте экспорт и импорт JSON через Git |
| Error с текстом про 404 | Неверный ключ файла или у токена нет доступа к файлу |
| Кнопка Compare Variables неактивна | Заполните оба поля |
| Ошибки под результатом после Sync | Переменная не смогла получить значение: чаще всего тип не совпадает. Исправьте её вручную и повторите |