Чаще всего boolean-свойства в Figma обсуждают как трюк для уменьшения числа вариантов: было 96 кнопок, стало 24, все довольны. На пустом файле так и есть. Ошибка начинается, когда этот же аргумент переносят на библиотеку, которой полтора года пользуются 30 продуктовых файлов. Там число вариантов перестаёт быть главной цифрой.
Важнее, что случится с тысячей экземпляров, которые уже стоят в макетах, с прототипами, построенными на переключении вариантов, и с компонентом в коде, который разработчики давно сверстали по старой модели. Ниже шесть последствий такого перехода, каждое со своим вопросом, на который команда дизайн-системы должна ответить до решения.
Последствие 1: число вариантов падает по формуле, и её стоит посчитать заранее
Набор вариантов в Figma устроен как декартово произведение: каждое значение каждого свойства умножается на все значения остальных. Отсюда взрывной рост, и отсюда же простая формула выгоды.
Вариантов в наборе = v1 × v2 × ... × vn
где vi = число значений i-го свойства варианта
Вариантов после перехода = (v1 × v2 × ... × vn) / 2^k
где k = число свойств вида «есть / нет», которые
стали boolean-свойствами компонента
Каждое свойство с двумя значениями «да» и «нет», вынесенное из вариантов в boolean, делит набор пополам. Три таких свойства делят его на 8, четыре на 16.
Посчитаем на условной кнопке. Размер: 3 значения. Тип: основная, вторичная, текстовая, то есть 3. Состояние: обычное, наведение, нажатие, отключено, то есть 4. Иконка слева: есть или нет. Иконка справа: есть или нет. Индикатор загрузки: есть или нет. Произведение 3 × 3 × 4 × 2 × 2 × 2 даёт 288 вариантов.
Три свойства «есть или нет» переезжают в boolean, k равно 3, и вариантов становится 288 / 8 = 36. Компонент сжался в 8 раз, файл библиотеки открывается быстрее, а дизайнер в панели свойств видит три переключателя вместо длинного выпадающего списка.
Полезно записать эту цифру в решение рядом с остальными. Но она описывает только сам компонент. Цена перехода лежит в следующих пяти пунктах.
Последствие 2: экземпляры в продуктовых файлах не переедут сами
Каждый экземпляр кнопки в продуктовом макете ссылается на конкретный вариант набора. Если вы удаляете вариант «Иконка слева = да», экземпляры, которые на него ссылались, теряют связь с актуальной версией компонента: они продолжают отображаться, но обновления библиотеки до них больше не доходят. Обнаруживается это обычно через месяц, когда кнопку перекрасили, а в половине макетов она осталась старой.
Отсюда второй вопрос для решения: сколько экземпляров затронет переход и кто их перенесёт. Данные о том, где и сколько раз используется компонент, видны в аналитике библиотеки на организационных тарифах. Условный пример. Кнопка используется 1 400 раз в 32 файлах. Из них 520 экземпляров стоят на вариантах с иконками или загрузкой, которые исчезнут.
Если перенос делать руками, на один экземпляр уходит около 20 секунд с учётом поиска и проверки, и 520 экземпляров займут почти 3 часа. Кажется немного, но эти 3 часа распределены по 32 файлам и 9 владельцам, и каждому надо объяснить, что и зачем менять.
Безопасный порядок выглядит так. Сначала в набор добавляются boolean-свойства, а старые варианты остаются, помеченные как устаревшие. Затем публикуется версия, и команды переводят свои экземпляры. Удаляются старые варианты только тогда, когда аналитика показывает, что на них почти не осталось ссылок. Это медленнее одномоментной замены, зато ни один макет не отвяжется молча.
Последствие 3: скрытые слои никуда не исчезают
Boolean-свойство в Figma управляет видимостью слоя. Выключили иконку, и слой иконки внутри экземпляра стал скрытым, но остался на месте. Для дизайнера это удобно: если в автолейауте слой скрыт, он не занимает места, и кнопка без иконки выглядит правильно без отдельного варианта.
У этого есть следствия, о которых редко думают при решении. Скрытый слой хранит свои переопределения. Если дизайнер заменил иконку на «корзину», потом выключил её, а через неделю включил снова, вернётся та же «корзина». Иногда это ровно то, что нужно, иногда источник путаницы, когда макет копируют в другой контекст и там внезапно появляется чужая иконка.
Второе следствие касается структуры компонента. Чем больше boolean-свойств, тем больше скрытых слоёв лежит в каждом экземпляре. У кнопки с тремя переключателями это незаметно. У карточки товара с 9 опциональными блоками (бейдж, рейтинг, старая цена, таймер, кнопка избранного и так далее) экземпляр несёт в себе всю тяжёлую структуру даже тогда, когда видны 2 блока. На экране с сотней карточек это уже ощущается при работе с файлом.
Отсюда практическое правило: boolean хорош для мелких опциональных элементов. Если опциональный блок сам по себе сложный компонент с вложенной структурой, подумайте о свойстве замены экземпляра или о слоте-заглушке вместо скрытого слоя.
Последствие 4: интерактивные состояния лучше оставить вариантами
В прототипах Figma взаимодействие «Change to» переключает экземпляр между вариантами набора. Именно на нём построены интерактивные компоненты: наведение, нажатие, раскрытие. Состояния, которые меняются в ответ на действие пользователя, естественно живут в вариантах.
Ошибка случается, когда в порыве сокращения в boolean переносят то, что на самом деле состояние. Например, «раскрыт» у аккордеона или «выбран» у чекбокса. Формально это тоже «да или нет», и формула из первого пункта соблазняет сократить ещё вдвое. Но прототип, где чекбокс отмечался по клику через переключение варианта, после такого переноса перестаёт работать. Восстанавливать его придётся через переменные: связать boolean-свойство с boolean-переменной и менять переменную действием в прототипе. Это работает, но требует перестройки каждого прототипа, где компонент участвовал.
Вопрос для решения звучит так: какие из свойств «да или нет» описывают состав компонента, а какие его поведение. Первые можно смело переводить в boolean. Вторые стоит оставить вариантами, даже если это означает набор в 2 раза больше. Хорошая проверка: если значение свойства меняется во время работы интерфейса от действия пользователя, это поведение. Если оно выбирается один раз при сборке экрана и дальше не меняется, это состав.
Последствие 5: разработчики увидят другую модель компонента
Свойства компонента в Figma видны разработчикам в режиме инспекции, и многие команды выстраивают их так, чтобы они совпадали с пропсами компонента в коде. Если в коде у кнопки давно есть пропсы iconLeft, iconRight и loading, переход на boolean-свойства с теми же именами сближает дизайн и код. Разработчику больше не нужно гадать, какой вариант из 288 соответствует какой комбинации пропсов.
Но бывает и наоборот. Если в коде иконка передаётся одним пропсом с возможными значениями «слева», «справа», «нет», а в Figma появляются два независимых переключателя, дизайн разрешает комбинацию «иконка и слева, и справа», которой в коде может не быть. Через месяц в макете появится кнопка, которую нельзя сверстать без доработки компонента.
Поэтому перед переходом стоит положить рядом две таблицы: свойства в Figma после перехода и пропсы в коде. Каждое расхождение либо исправляется в одной из сторон, либо явно описывается в документации компонента. Хорошо, если в этом разговоре участвует фронтенд-разработчик, который отвечает за библиотеку в коде: ему проще сразу сказать, какие комбинации допустимы.
Последствие 6: документация и публикация требуют отдельного чек-листа
Переход меняет то, как компонент выглядит в панели свойств, в документации и в списке изменений библиотеки. Чтобы ничего не потерять, перед публикацией стоит пройти короткий список.
- Каждое boolean-свойство названо так, как его поймёт человек, не участвовавший в переходе: «Иконка слева», а не «Bool 1».
- Значение по умолчанию у каждого переключателя совпадает с самым частым использованием в продуктовых файлах.
- Свойства, описывающие поведение (выбран, раскрыт, нажат), остались вариантами.
- Старые варианты помечены как устаревшие и не удалены до переноса экземпляров.
- Таблица соответствия свойств Figma и пропсов кода обновлена.
- В описании версии библиотеки указано, какие экземпляры нужно перевести и как.
- Проверены 3 или 4 самых используемых прототипа, где компонент участвует во взаимодействиях.
- Назначена дата, когда по аналитике библиотеки проверяется число ссылок на устаревшие варианты.
Список короткий, и каждый пункт в нём закрывает одну из ошибок, описанных выше. Если какой-то пункт не выполняется, публикацию лучше отложить на день, чем потом разбираться с отвязанными экземплярами в 30 файлах.
Решение и случаи, когда переход не нужен
Рекомендация из этой записки: переводить в boolean-свойства только опциональные элементы состава компонента (иконки, бейджи, подписи, разделители), делать это через этап сосуществования со старыми вариантами и удалять варианты только после переноса экземпляров. Ожидаемая выгода измеряется формулой из первого пункта, ожидаемая цена числом затронутых экземпляров и прототипов.
Однако бывают ситуации, когда переход лучше не начинать вовсе. Если компонент используется в 1 или 2 файлах и вариантов в нём меньше 20, выигрыш почти незаметен, а работа по миграции всё равно нужна. Если в ближайшие 2 месяца компонент будет переделан с нуля из-за ребрендинга, переход сейчас означает двойную работу.
Если код компонента устроен иначе и менять его никто не планирует, boolean-свойства создадут в дизайне комбинации, которые разработка не поддержит. И если в команде дизайн-системы нет человека, который проследит за переносом экземпляров в продуктовых файлах, старые варианты так и останутся висеть, а библиотека получит две параллельные модели одного компонента. В любом из этих случаев 288 вариантов, которые никому не мешают работать, лучше оставить как есть.