Подход к работе
Component Spec описывает один компонент дизайн-системы. Передача работы строится вокруг анатомии, вариантов, свойств API, интерактивных состояний, адаптивного поведения, доступности и использования. Обязательные и необязательные части обозначаются явно.
Цель — согласие между дизайнерами и разработчиками. Статичный скриншот не передаёт поведение кнопки при загрузке или возврат фокуса в диалоге. Поэтому источник требует примеров и граничных случаев, а более широкие шаблоны документации и паттерны из нескольких компонентов в эту задачу не входят.
Ожидаемые результаты
- Спецификация анатомии и вариантов
- Таблица свойств (props) с типами, значениями по умолчанию и признаком обязательности
- Правила состояний, поведения, доступности и использования
От брифа до проверки
- 01Определите границы компонента
Опишите его назначение, случаи применения, а также обязательные и необязательные части.
- 02Опишите API и состояния
Назовите свойства и варианты, затем опишите поведение по умолчанию, при фокусе, в отключённом состоянии, при загрузке и, где уместно, при ошибке.
- 03Проработайте детали взаимодействия
Задокументируйте поведение клавиатуры, фокуса, адаптивности и граничных случаев на примерах, которые можно проверить при реализации.