Никита АлимпиевNikAlimp

Вариант компонента

Component Variant

Вариант компонента — это один из вариантов внешнего вида или состояния одного и того же компонента интерфейса: кнопка основная и второстепенная, поле ввода обычное и с ошибкой, карточка крупная и компактная. По-английски — variant.

Идея в том, чтобы не рисовать и не писать множество отдельных элементов, а держать один компонент с набором параметров. Дизайнер в Figma собирает «набор вариантов»: все комбинации размера, типа и состояния живут в одной сущности, а переключаются через свойства. Разработчик в коде делает то же самое: один компонент принимает параметры вроде размера и вида. Так дизайн и разработка говорят на одном языке, а интерфейс остаётся единообразным.

Свойства вариантов делятся на несколько видов. Тип или стиль — основной, второстепенный, текстовый. Размер — малый, средний, крупный. Состояние — обычное, наведение, нажатие, фокус, отключено (Состояния элемента). Булевы переключатели — с иконкой или без неё. Каждое сочетание должно быть описано, иначе в продукте появятся нестандартные кнопки.

Пример

Компонент «Кнопка» имеет свойства: вид (основная, вторичная, текстовая), размер (малая, средняя, крупная), иконка (нет, слева, справа) и состояние (обычная, наведение, нажата, отключена). Дизайнер ставит в макет один экземпляр и выбирает нужную комбинацию. Если команда меняет радиус скругления, он обновляется во всех вариантах сразу.

Как продумать варианты

  1. Выпишите, чем реально отличаются экземпляры компонента в продукте.
  2. Сгруппируйте различия по осям: вид, размер, состояние, наличие иконки.
  3. Назовите свойства и значения понятно и одинаково в дизайне и коде.
  4. Исключите бессмысленные комбинации, например отключённая кнопка с наведением.
  5. Подключите значения из токенов, чтобы цвета и отступы не зашивались вручную.
  6. Опишите в документации, когда какой вариант применять.

Типичные ошибки

  • Завести отдельный компонент под каждый случай вместо одного с параметрами.
  • Слишком много осей, из-за чего комбинаций тысячи, и никто не знает, какие реально нужны.
  • Разные названия свойств у дизайнеров и разработчиков.
  • Забыть про состояния фокуса и ошибки, важные для доступности.
  • Править отдельные экземпляры вручную, ломая связь с основным компонентом.

Чем отличается от экземпляра

Экземпляр (instance) — конкретная копия компонента в макете. Вариант — заранее определённая версия самого компонента. Экземпляр выбирает один из вариантов и при необходимости переопределяет текст или иконку.

Частый вопрос

Сколько вариантов должно быть у компонента? Столько, сколько реально нужно продукту, и не больше. Начните с минимума, добавляйте вариант только когда он повторяется в нескольких местах. Если комбинаций становится слишком много, пересмотрите компонент: возможно, это два разных элемента.

Подборки по теме

Дизайн сайта

Сайт с эксклюзивным дизайном, а не шаблоном

Свой визуал, шрифты и анимация под ваш характер — и разметка, чтобы сайт находили в Яндексе и нейросетях. Личный сайт — 150 000 ₽, корпоративный — 250 000 ₽.

Или написать в Telegram

Удобнее голосом? Запишитесь на 30 минут в Zoom — разберём задачу и решим, с чего начать.