Принцип работы
Building Components — руководство по инженерным решениям для переиспользуемой UI-библиотеки. Оно направляет агента к отдельным материалам о композиции, работе с клавиатурой, управлении состоянием, интерфейсах TypeScript и стилях. Входной документ охватывает примитивы, компоненты, блоки и шаблоны, позволяя выбирать уровень абстракции под реальный результат.
Навык полезен, когда компонент должен обслуживать несколько потребителей, а не один отдельный экран. Он объединяет обсуждение формы API, доступности и распространения. Источник преимущественно является указателем справочных материалов: связанные файлы входят в рабочий навык и должны поставляться вместе с входным файлом.
Ожидаемые результаты
- Для запроса на реализацию — компонент с явной моделью композиции и состояния.
- Для запроса на документацию — руководство по API компонента и соответствующему поведению.
- Подходящий план упаковки или размещения в реестре, если запрос включает распространение.
От задания до проверки
- 01Определите контракт компонента
Решите, относится ли задача к примитиву, компоненту, блоку или шаблону. Определите публичный интерфейс и контексты, в которых вызывающий код будет его компоновать.
- 02Прочитайте нужные инженерные рекомендации
Изучите state.mdx для управляемого и неуправляемого поведения, composition.mdx для публичной модели композиции и accessibility.mdx для требований к клавиатуре и фокусу. Для реализации обратитесь к types.mdx и styling.mdx. Добавляйте материалы о polymorphism или as-child только тогда, когда вызывающему коду нужны эти паттерны API.
- 03Реализуйте и опишите API
Свяжите состояние и представление через выбранный API. Объясните предполагаемое использование и выбирайте npm, реестр или иной описанный способ распространения только при необходимости.