Что передать разработчику из Figma: компоненты, состояния и адаптивные макеты
Что передать разработчику из Figma — вопрос не о количестве нарисованных экранов, а о том, сможет ли человек собрать интерфейс, ничего не угадывая. Красивый макет с проработанными картинками часто рассыпается на этапе вёрстки: непонятно, как ведёт себя блок при сжатии, что происходит с кнопкой во время отправки формы, какой отступ считать системным, а какой — случайным. Передача работает как техническое задание. Чем меньше в ней формулировки «там разберёшься», тем спокойнее идёт разработка и тем меньше правок возвращается на второй круг.
Ниже — практический разбор того, что стоит положить в передачу: компоненты, состояния, адаптивные версии и сопроводительная спецификация. Материал подойдёт и дизайнеру, который отдаёт макет, и разработчику, который его принимает.
Что передать разработчику из Figma: состав передачи
Ссылка на файл сама по себе — не передача. Файл становится рабочей документацией, когда в нём есть порядок, а рядом лежит описание того, что проще объяснить словами, чем рисовать. Хорошая передача отвечает на три вопроса: что нарисовано, как это должно себя вести и что из этого можно менять.
Базовый набор артефактов выглядит так:
- сам файл Figma с понятной структурой страниц — например, отдельно компоненты, отдельно экраны, отдельно адаптивные версии, отдельно архив;
- библиотека компонентов и стилей, если она есть, или хотя бы единый набор повторяющихся элементов;
- описание состояний для интерактивных элементов и экранов с данными;
- адаптивные версии ключевых экранов и правила поведения между ними;
- спецификация текстом: сетка, отступы, типографика, поведение при разных объёмах контента;
- ассеты: иконки, изображения, шрифты и правила их экспорта;
- список открытых вопросов и договорённостей, если часть решений ещё не финальна.
Полезно сразу договориться о границах задачи. Одно дело — перенести в код готовый экран, другое — собрать из макета полноценную дизайн-систему с адаптивом. Объём влияет на то, сколько деталей нужно в передаче, и лучше проговорить это до старта, а не в середине работы.
Компоненты: границы, варианты и повторяемость
Компонент в Figma — это не только визуальный блок, но и единица договорённости. Разработчику нужно понимать, где заканчивается один компонент и начинается другой, какие у него варианты и какие свойства вообще могут меняться. Если кнопка нарисована десять раз с разными отступами, разработчик либо сделает десять кнопок, либо приведёт их к одной и придёт с вопросом, какая версия правильная. В обоих случаях это лишняя работа.
Именование и вложенность
Имена компонентов читаются в инспекторе и часто почти дословно переносятся в код, поэтому случайные названия вроде «Frame 427» создают лишний слой перевода. Рабочая схема имени — от общего к частному: категория, элемент, вариант. Например, «button / primary / large» или «card / product / compact». Договорённость об именах стоит зафиксировать один раз: дальше она экономит время на каждой следующей передаче.
Вложенность тоже имеет значение. Когда кнопка внутри карточки — это отдельный компонент, а не набор прямоугольников и текстовых слоёв, разработчик видит переиспользуемую единицу. Когда всё нарисовано «плоско», приходится разбирать макет по слоям и восстанавливать логику вручную. Если проект небольшой и библиотеки ещё нет, достаточно привести к единому виду повторяющиеся элементы: кнопки, поля ввода, ссылки, заголовки, карточки. О том, как из такого набора складываются компоненты сайта, полезно почитать в материале как выбрать компоненты для сайта на Vue и проверить работу форм.
Иконки, изображения и экспорт
Иконки отдавайте вектором, а не растром, если они должны менять цвет и масштабироваться без потерь. Проверьте, что иконка не «склеена» с текстом в один слой и не нарисована обводкой, которая поедет при изменении размера. Для фотографий полезно указать пропорции и поведение при обрезке: что важнее сохранить — центр, верх или конкретную область.
Отдельно проговорите шрифты: какие начертания используются, есть ли у них лицензия на веб-подключение, нужны ли альтернативы. Это тот случай, когда вопрос лучше задать до вёрстки, а не после.
Что проверить в компоненте перед передачей
- у каждого повторяющегося элемента есть одно имя и один набор вариантов;
- размеры и отступы внутри компонента заданы одинаково во всех вариантах;
- цвета и типографика привязаны к стилям, а не выставлены вручную в каждом слое;
- у интерактивных элементов описаны состояния, а не только вид по умолчанию;
- иконки и изображения вынесены в отдельные слои с понятными именами;
- нет скрытых слоёв и «мусорных» копий, которые остались от экспериментов.
Состояния: где чаще всего теряется логика
Статичный экран показывает один сценарий — «всё хорошо». Реальный интерфейс живёт в переходах: пользователь нажал, данные не пришли, поле заполнено неверно, список пуст. Если этих ситуаций нет в макете, разработчик всё равно их сделает, но по своему усмотрению. Иногда получается удачно, иногда — нет, и тогда правки возвращаются уже на этапе тестирования.
Минимальный набор состояний для интерактивных элементов: обычное, наведение, фокус с клавиатуры, нажатие, недоступное, загрузка. Для экранов с данными добавляются пустое состояние, ошибка, частичная загрузка и ситуация «нет прав доступа». Для форм — валидация до отправки, ошибка после отправки и состояние успеха.
Список состояний, которые стоит описать хотя бы текстом:
- поле ввода: пустое, заполненное, с подсказкой, с ошибкой, недоступное;
- кнопка: обычная, наведение, фокус, нажатие, недоступная, «отправляется»;
- список или таблица: загрузка, данные есть, данных нет, ошибка загрузки;
- длинный текст: обрезка, перенос, всплывающая подсказка;
- модальное окно: открытие, закрытие, блокировка фона, возврат фокуса;
- уведомления: успех, предупреждение, ошибка и то, как они исчезают.
Не обязательно рисовать каждое состояние отдельным фреймом. Часто достаточно компактной секции «состояния» рядом с компонентом или короткой таблицы в спецификации. Важнее, чтобы решение было принято дизайнером, а не выбрано разработчиком по умолчанию. Как такие сценарии проверяются на стороне кода, разобрано в статье как проверить React-интерфейс: состояния загрузки, формы и обработка ошибок.
Отдельная группа — поведение, связанное с доступностью: видимый фокус, контраст, размер интерактивных зон, порядок обхода с клавиатуры. Точные требования к доступности лучше сверять с актуальной версией профильного стандарта (например, WCAG) и внутренними правилами проекта: формулировки и уровни соответствия там обновляются, и пересказ по памяти здесь плохой помощник.
Адаптивные макеты: важны правила, а не три картинки
Три экрана — «мобильный», «планшет», «десктоп» — сами по себе мало что объясняют. Между ними существует бесконечное число ширин, и интерфейс должен выглядеть разумно на каждой. Поэтому в передачу идут не только крайние состояния, но и логика перехода.
Сначала зафиксируйте брейкпоинты: на каких ширинах макет меняется и почему именно на них. Затем опишите, что происходит в промежутке — тянется ли блок пропорционально, растут ли отступы, остаётся ли контент в фиксированной колонке. Отдельно проговорите поведение сетки: сколько колонок, какой максимальный размер контейнера, что происходит с ним на широких экранах.
Для каждого сложного блока стоит ответить на несколько вопросов:
- какие элементы меняют порядок или переносятся на новую строку;
- что скрывается и не теряется ли при этом важная информация;
- как ведёт себя навигация: остаётся полной или сворачивается в компактный вариант;
- какие размеры интерактивных элементов сохраняются на сенсорных экранах;
- как обрезаются и масштабируются изображения;
- что происходит с таблицами и широкими блоками при нехватке места.
Полезно нарисовать не только «идеальные» ширины, но и проблемные: очень узкий экран, очень широкий монитор, экран с увеличенным системным шрифтом. Это дешевле, чем ловить такие случаи на этапе приёмки.
Спецификация: что зафиксировать текстом
Часть решений удобнее описать словами, чем рисовать. Ниже — ориентир по разделам: заполнять всё подряд не нужно, но пропускать разделы стоит осознанно.
| Область | Что указать | Зачем это разработчику |
|---|---|---|
| Сетка и отступы | Ширина контейнера, число колонок, шаг отступов | Чтобы spacing был системным, а не «на глаз» |
| Типографика | Размеры, начертания, межстрочные интервалы, поведение при переносе | Чтобы тексты выглядели одинаково на всех экранах |
| Цвета и стили | Палитра, названия токенов, где применяется каждый | Чтобы значения не расползались по коду |
| Компоненты | Список компонентов и их вариантов | Чтобы совпали границы переиспользуемых блоков |
| Состояния | Перечень состояний и правила перехода между ними | Чтобы поведение не пришлось додумывать |
| Адаптивность | Брейкпоинты и правила поведения между ними | Чтобы промежуточные ширины не ломались |
| Контент | Реальные тексты, максимальные длины, примеры длинных значений | Чтобы вёрстка выдержала жизнь, а не демо-данные |
| Ассеты | Форматы, имена файлов, правила экспорта | Чтобы не собирать иконки заново |
| Анимация | Что и когда двигается, есть ли задержки | Чтобы микровзаимодействия не изобретались в коде |
Если в проекте есть дизайн-токены, отдельная таблица значений снимает половину вопросов: разработчик видит не «серый текст», а конкретное имя стиля. Если токенов нет, достаточно единого списка используемых цветов и размеров — это уже лучше, чем значения, собранные из разных слоёв.
Как передавать: порядок действий и чек-лист
Передача редко бывает одномоментной. Обычно она идёт волнами: сначала общий каркас, потом детали, потом правки. Чтобы не утонуть, помогает последовательность.
- Согласуйте объём: какие экраны и сценарии входят в текущий этап.
- Приведите файл в порядок: имена, страницы, компоненты, отсутствие лишних слоёв.
- Соберите спецификацию и вынесите открытые вопросы отдельным списком.
- Пройдите макет вместе с разработчиком: короткий разбор экономит часы переписки.
- Зафиксируйте договорённости письменно — в файле, в задаче или в отдельном документе.
- Поддерживайте файл в актуальном состоянии, пока идёт разработка.
Последний пункт часто недооценивают. Если макет меняется после передачи, а файл остаётся прежним, дизайнер и разработчик начинают смотреть на разные версии правды. Простое правило «изменение сначала в макете, потом в задаче» снимает большую часть споров.
И ещё одно: передача — это не экзамен для дизайнера и не тест на внимательность для разработчика. Обе стороны выигрывают, когда странные места проговариваются вслух. Если макет требует пояснений, лучше дать их сразу — короткой заметкой рядом с компонентом или абзацем в спецификации.
Нужно ли рисовать все состояния каждого компонента?
Не обязательно отдельными фреймами. Достаточно перечислить состояния рядом с компонентом или в таблице спецификации, если из описания понятно, чем одно состояние отличается от другого. Полноценные макеты нужны там, где состояние меняет композицию, а не только цвет или размер.
Сколько адаптивных макетов достаточно передать?
Зависит от проекта. Минимум — ключевые ширины, между которыми описаны правила поведения: как тянется сетка, что переносится, что скрывается. Лучше меньше экранов, но с описанной логикой, чем пять картинок без пояснений.
Что делать, если дизайн-системы ещё нет?
Приведите к единому виду повторяющиеся элементы, зафиксируйте используемые цвета и размеры списком, назовите компоненты по одной схеме. Полная дизайн-система для старта не обязательна — достаточно, чтобы одинаковые элементы выглядели и назывались одинаково.
Нужен ли интерактивный прототип?
Он помогает показать переходы и логику, но не заменяет спецификацию. Если прототип есть, укажите, какие сценарии в нём главные и что считается образцом поведения. Если прототипа нет, опишите переходы текстом рядом с соответствующими экранами.
Как передавать тексты и иконки?
Реальные тексты — в макете или отдельным списком с указанием максимальных длин. Иконки — вектором, с понятными именами и правилами экспорта. Демонстрационные заглушки вместо настоящих текстов лучше заменить до передачи, иначе вёрстка проверится только на коротких строках.
Что делать, если макет меняется во время разработки?
Договориться о порядке: изменение сначала попадает в файл и в задачу, а затем в код. Так у дизайнера и разработчика остаётся одна актуальная версия, и не возникает спора о том, какой скриншот считать правильным.