Composition и Drift
Как Inspect следит за компонентами, созданными из композиции: связь Linked и Unlinked, Re-link, Adopt composition для старых компонентов, секция Out of Sync с категориями различий, Show Diff и Re-apply.
Если компонент или набор вариантов создан из композиции, Inspect может сравнить его текущее состояние в Figma с JSON-описанием. Расхождение между ними называется drift.
Откуда берётся drift:
- слой поправили на холсте после генерации;
- JSON обновили, но изменения ещё не применили в Figma;
- компонент пересоздали или перенесли, и связь с композицией устарела.
Composition Tracking
Для компонента, связанного с композицией, Inspect показывает состояние связи:
| Состояние | Что означает | Что делать |
|---|---|---|
| Linked | Компонент связан с композицией по имени и идентификатору | Ничего |
| Unlinked | Имя совпадает с композицией, но идентификатор компонента изменился | Нажмите Re-link, чтобы обновить связь в этом файле |
Компонент, который никогда не создавался из композиции, сначала нужно связать с ней вручную: на вкладке Tokens откройте меню бейджа композиции и выберите Adopt composition для выделенного компонента. После этого Audit composition и Inspect смогут сравнивать его с JSON.
Out of Sync
Если drift найден, в панели появляется секция Out of Sync: общее число различий, бейджи категорий и кнопки Show Diff и Re-apply.
| Категория | Что сравнивается |
|---|---|
structure | Иерархия и порядок слоёв |
property | Свойства компонента |
binding | Привязки токенов и переменных |
layout | Автолейаут: направление, отступы, промежутки |
fill, stroke, effect | Заливки, обводки, эффекты |
text | Текстовые свойства |
sizing | Размеры и ограничения |
style | Привязанные стили |
Show Diff открывает подробное сравнение по категориям и путям слоёв. Посмотрите его перед восстановлением, чтобы понять, какие правки на холсте будут перезаписаны.
Re-apply приводит компонент к JSON: структура, стили и привязки восстанавливаются, а сам слой и его идентификатор сохраняются, поэтому инстансы не ломаются. Для набора вариантов восстановление проходит по каждому варианту. После успешного Re-apply секция Out of Sync исчезает.
Рекомендуемый порядок
- Выделите компонент или набор вариантов.
- Проверьте состояние в Composition Tracking. Если Unlinked, нажмите Re-link.
- Если есть Out of Sync, откройте Show Diff и оцените различия.
- Если правки на холсте нужно сохранить, перенесите их в JSON композиции и примените заново с вкладки Tokens. Если нет, нажмите Re-apply.
- Убедитесь, что секция Out of Sync исчезла.