К содержимому
← Вернуться в блог

Что передать разработчику из Figma: компоненты, состояния и адаптивные макеты

Что передать разработчику из Figma — вопрос не о количестве нарисованных экранов, а о том, сможет ли человек собрать интерфейс, ничего не угадывая. Красивый макет с проработанными картинками часто рассыпается на этапе вёрстки: непонятно, как ведёт себя блок при сжатии, что происходит с кнопкой во время отправки формы, какой отступ считать системным, а какой — случайным. Передача работает как техническое задание. Чем меньше в ней формулировки «там разберёшься», тем спокойнее идёт разработка и тем меньше правок возвращается на второй круг.

Ниже — практический разбор того, что стоит положить в передачу: компоненты, состояния, адаптивные версии и сопроводительная спецификация. Материал подойдёт и дизайнеру, который отдаёт макет, и разработчику, который его принимает.

Что передать разработчику из Figma: состав передачи

Ссылка на файл сама по себе — не передача. Файл становится рабочей документацией, когда в нём есть порядок, а рядом лежит описание того, что проще объяснить словами, чем рисовать. Хорошая передача отвечает на три вопроса: что нарисовано, как это должно себя вести и что из этого можно менять.

Базовый набор артефактов выглядит так:

  • сам файл Figma с понятной структурой страниц — например, отдельно компоненты, отдельно экраны, отдельно адаптивные версии, отдельно архив;
  • библиотека компонентов и стилей, если она есть, или хотя бы единый набор повторяющихся элементов;
  • описание состояний для интерактивных элементов и экранов с данными;
  • адаптивные версии ключевых экранов и правила поведения между ними;
  • спецификация текстом: сетка, отступы, типографика, поведение при разных объёмах контента;
  • ассеты: иконки, изображения, шрифты и правила их экспорта;
  • список открытых вопросов и договорённостей, если часть решений ещё не финальна.

Полезно сразу договориться о границах задачи. Одно дело — перенести в код готовый экран, другое — собрать из макета полноценную дизайн-систему с адаптивом. Объём влияет на то, сколько деталей нужно в передаче, и лучше проговорить это до старта, а не в середине работы.

Компоненты: границы, варианты и повторяемость

Компонент в Figma — это не только визуальный блок, но и единица договорённости. Разработчику нужно понимать, где заканчивается один компонент и начинается другой, какие у него варианты и какие свойства вообще могут меняться. Если кнопка нарисована десять раз с разными отступами, разработчик либо сделает десять кнопок, либо приведёт их к одной и придёт с вопросом, какая версия правильная. В обоих случаях это лишняя работа.

Именование и вложенность

Имена компонентов читаются в инспекторе и часто почти дословно переносятся в код, поэтому случайные названия вроде «Frame 427» создают лишний слой перевода. Рабочая схема имени — от общего к частному: категория, элемент, вариант. Например, «button / primary / large» или «card / product / compact». Договорённость об именах стоит зафиксировать один раз: дальше она экономит время на каждой следующей передаче.

Вложенность тоже имеет значение. Когда кнопка внутри карточки — это отдельный компонент, а не набор прямоугольников и текстовых слоёв, разработчик видит переиспользуемую единицу. Когда всё нарисовано «плоско», приходится разбирать макет по слоям и восстанавливать логику вручную. Если проект небольшой и библиотеки ещё нет, достаточно привести к единому виду повторяющиеся элементы: кнопки, поля ввода, ссылки, заголовки, карточки. О том, как из такого набора складываются компоненты сайта, полезно почитать в материале как выбрать компоненты для сайта на Vue и проверить работу форм.

Иконки, изображения и экспорт

Иконки отдавайте вектором, а не растром, если они должны менять цвет и масштабироваться без потерь. Проверьте, что иконка не «склеена» с текстом в один слой и не нарисована обводкой, которая поедет при изменении размера. Для фотографий полезно указать пропорции и поведение при обрезке: что важнее сохранить — центр, верх или конкретную область.

Отдельно проговорите шрифты: какие начертания используются, есть ли у них лицензия на веб-подключение, нужны ли альтернативы. Это тот случай, когда вопрос лучше задать до вёрстки, а не после.

Что проверить в компоненте перед передачей

  • у каждого повторяющегося элемента есть одно имя и один набор вариантов;
  • размеры и отступы внутри компонента заданы одинаково во всех вариантах;
  • цвета и типографика привязаны к стилям, а не выставлены вручную в каждом слое;
  • у интерактивных элементов описаны состояния, а не только вид по умолчанию;
  • иконки и изображения вынесены в отдельные слои с понятными именами;
  • нет скрытых слоёв и «мусорных» копий, которые остались от экспериментов.
Совет. Если времени мало, наведите порядок не во всём файле, а в пяти-семи компонентах, которые встречаются на большинстве экранов. Кнопки, поля ввода, карточки и навигация дают наибольший эффект: именно вокруг них возникает больше всего вопросов при вёрстке.

Состояния: где чаще всего теряется логика

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

Минимальный набор состояний для интерактивных элементов: обычное, наведение, фокус с клавиатуры, нажатие, недоступное, загрузка. Для экранов с данными добавляются пустое состояние, ошибка, частичная загрузка и ситуация «нет прав доступа». Для форм — валидация до отправки, ошибка после отправки и состояние успеха.

Список состояний, которые стоит описать хотя бы текстом:

  • поле ввода: пустое, заполненное, с подсказкой, с ошибкой, недоступное;
  • кнопка: обычная, наведение, фокус, нажатие, недоступная, «отправляется»;
  • список или таблица: загрузка, данные есть, данных нет, ошибка загрузки;
  • длинный текст: обрезка, перенос, всплывающая подсказка;
  • модальное окно: открытие, закрытие, блокировка фона, возврат фокуса;
  • уведомления: успех, предупреждение, ошибка и то, как они исчезают.

Не обязательно рисовать каждое состояние отдельным фреймом. Часто достаточно компактной секции «состояния» рядом с компонентом или короткой таблицы в спецификации. Важнее, чтобы решение было принято дизайнером, а не выбрано разработчиком по умолчанию. Как такие сценарии проверяются на стороне кода, разобрано в статье как проверить React-интерфейс: состояния загрузки, формы и обработка ошибок.

Отдельная группа — поведение, связанное с доступностью: видимый фокус, контраст, размер интерактивных зон, порядок обхода с клавиатуры. Точные требования к доступности лучше сверять с актуальной версией профильного стандарта (например, WCAG) и внутренними правилами проекта: формулировки и уровни соответствия там обновляются, и пересказ по памяти здесь плохой помощник.

Внимание. Не оставляйте «дыры» в состояниях молча. Если решение не принято, отметьте это прямо в спецификации как открытый вопрос. Разработчик, который додумал поведение сам, потратит время на реализацию, а потом, возможно, будет переделывать её после согласования.

Адаптивные макеты: важны правила, а не три картинки

Три экрана — «мобильный», «планшет», «десктоп» — сами по себе мало что объясняют. Между ними существует бесконечное число ширин, и интерфейс должен выглядеть разумно на каждой. Поэтому в передачу идут не только крайние состояния, но и логика перехода.

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

Для каждого сложного блока стоит ответить на несколько вопросов:

  • какие элементы меняют порядок или переносятся на новую строку;
  • что скрывается и не теряется ли при этом важная информация;
  • как ведёт себя навигация: остаётся полной или сворачивается в компактный вариант;
  • какие размеры интерактивных элементов сохраняются на сенсорных экранах;
  • как обрезаются и масштабируются изображения;
  • что происходит с таблицами и широкими блоками при нехватке места.

Полезно нарисовать не только «идеальные» ширины, но и проблемные: очень узкий экран, очень широкий монитор, экран с увеличенным системным шрифтом. Это дешевле, чем ловить такие случаи на этапе приёмки.

Спецификация: что зафиксировать текстом

Часть решений удобнее описать словами, чем рисовать. Ниже — ориентир по разделам: заполнять всё подряд не нужно, но пропускать разделы стоит осознанно.

Область Что указать Зачем это разработчику
Сетка и отступы Ширина контейнера, число колонок, шаг отступов Чтобы spacing был системным, а не «на глаз»
Типографика Размеры, начертания, межстрочные интервалы, поведение при переносе Чтобы тексты выглядели одинаково на всех экранах
Цвета и стили Палитра, названия токенов, где применяется каждый Чтобы значения не расползались по коду
Компоненты Список компонентов и их вариантов Чтобы совпали границы переиспользуемых блоков
Состояния Перечень состояний и правила перехода между ними Чтобы поведение не пришлось додумывать
Адаптивность Брейкпоинты и правила поведения между ними Чтобы промежуточные ширины не ломались
Контент Реальные тексты, максимальные длины, примеры длинных значений Чтобы вёрстка выдержала жизнь, а не демо-данные
Ассеты Форматы, имена файлов, правила экспорта Чтобы не собирать иконки заново
Анимация Что и когда двигается, есть ли задержки Чтобы микровзаимодействия не изобретались в коде

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

Как передавать: порядок действий и чек-лист

Передача редко бывает одномоментной. Обычно она идёт волнами: сначала общий каркас, потом детали, потом правки. Чтобы не утонуть, помогает последовательность.

  1. Согласуйте объём: какие экраны и сценарии входят в текущий этап.
  2. Приведите файл в порядок: имена, страницы, компоненты, отсутствие лишних слоёв.
  3. Соберите спецификацию и вынесите открытые вопросы отдельным списком.
  4. Пройдите макет вместе с разработчиком: короткий разбор экономит часы переписки.
  5. Зафиксируйте договорённости письменно — в файле, в задаче или в отдельном документе.
  6. Поддерживайте файл в актуальном состоянии, пока идёт разработка.

Последний пункт часто недооценивают. Если макет меняется после передачи, а файл остаётся прежним, дизайнер и разработчик начинают смотреть на разные версии правды. Простое правило «изменение сначала в макете, потом в задаче» снимает большую часть споров.

И ещё одно: передача — это не экзамен для дизайнера и не тест на внимательность для разработчика. Обе стороны выигрывают, когда странные места проговариваются вслух. Если макет требует пояснений, лучше дать их сразу — короткой заметкой рядом с компонентом или абзацем в спецификации.

Нужно ли рисовать все состояния каждого компонента?

Не обязательно отдельными фреймами. Достаточно перечислить состояния рядом с компонентом или в таблице спецификации, если из описания понятно, чем одно состояние отличается от другого. Полноценные макеты нужны там, где состояние меняет композицию, а не только цвет или размер.

Сколько адаптивных макетов достаточно передать?

Зависит от проекта. Минимум — ключевые ширины, между которыми описаны правила поведения: как тянется сетка, что переносится, что скрывается. Лучше меньше экранов, но с описанной логикой, чем пять картинок без пояснений.

Что делать, если дизайн-системы ещё нет?

Приведите к единому виду повторяющиеся элементы, зафиксируйте используемые цвета и размеры списком, назовите компоненты по одной схеме. Полная дизайн-система для старта не обязательна — достаточно, чтобы одинаковые элементы выглядели и назывались одинаково.

Нужен ли интерактивный прототип?

Он помогает показать переходы и логику, но не заменяет спецификацию. Если прототип есть, укажите, какие сценарии в нём главные и что считается образцом поведения. Если прототипа нет, опишите переходы текстом рядом с соответствующими экранами.

Как передавать тексты и иконки?

Реальные тексты — в макете или отдельным списком с указанием максимальных длин. Иконки — вектором, с понятными именами и правилами экспорта. Демонстрационные заглушки вместо настоящих текстов лучше заменить до передачи, иначе вёрстка проверится только на коротких строках.

Что делать, если макет меняется во время разработки?

Договориться о порядке: изменение сначала попадает в файл и в задачу, а затем в код. Так у дизайнера и разработчика остаётся одна актуальная версия, и не возникает спора о том, какой скриншот считать правильным.