Вариант компонента — это один из вариантов внешнего вида или состояния одного и того же компонента интерфейса: кнопка основная и второстепенная, поле ввода обычное и с ошибкой, карточка крупная и компактная. По-английски — variant.
Идея в том, чтобы не рисовать и не писать множество отдельных элементов, а держать один компонент с набором параметров. Дизайнер в Figma собирает «набор вариантов»: все комбинации размера, типа и состояния живут в одной сущности, а переключаются через свойства. Разработчик в коде делает то же самое: один компонент принимает параметры вроде размера и вида. Так дизайн и разработка говорят на одном языке, а интерфейс остаётся единообразным.
Свойства вариантов делятся на несколько видов. Тип или стиль — основной, второстепенный, текстовый. Размер — малый, средний, крупный. Состояние — обычное, наведение, нажатие, фокус, отключено (Состояния элемента). Булевы переключатели — с иконкой или без неё. Каждое сочетание должно быть описано, иначе в продукте появятся нестандартные кнопки.
Пример
Компонент «Кнопка» имеет свойства: вид (основная, вторичная, текстовая), размер (малая, средняя, крупная), иконка (нет, слева, справа) и состояние (обычная, наведение, нажата, отключена). Дизайнер ставит в макет один экземпляр и выбирает нужную комбинацию. Если команда меняет радиус скругления, он обновляется во всех вариантах сразу.
Как продумать варианты
- Выпишите, чем реально отличаются экземпляры компонента в продукте.
- Сгруппируйте различия по осям: вид, размер, состояние, наличие иконки.
- Назовите свойства и значения понятно и одинаково в дизайне и коде.
- Исключите бессмысленные комбинации, например отключённая кнопка с наведением.
- Подключите значения из токенов, чтобы цвета и отступы не зашивались вручную.
- Опишите в документации, когда какой вариант применять.
Типичные ошибки
- Завести отдельный компонент под каждый случай вместо одного с параметрами.
- Слишком много осей, из-за чего комбинаций тысячи, и никто не знает, какие реально нужны.
- Разные названия свойств у дизайнеров и разработчиков.
- Забыть про состояния фокуса и ошибки, важные для доступности.
- Править отдельные экземпляры вручную, ломая связь с основным компонентом.
Чем отличается от экземпляра
Экземпляр (instance) — конкретная копия компонента в макете. Вариант — заранее определённая версия самого компонента. Экземпляр выбирает один из вариантов и при необходимости переопределяет текст или иконку.
Частый вопрос
Сколько вариантов должно быть у компонента? Столько, сколько реально нужно продукту, и не больше. Начните с минимума, добавляйте вариант только когда он повторяется в нескольких местах. Если комбинаций становится слишком много, пересмотрите компонент: возможно, это два разных элемента.