Перейти к содержимому
v2.5.0
English
Русский
Документация

Примитивы раскладки

Используйте эту страницу, когда интерфейсу в основном нужны структура, группировка, отступы или низкоуровневая композиция, а не специализированное продуктовое взаимодействие.

Быстрые правила выбора

  • Используйте Card как нейтральную поверхность для группировки.
  • Используйте Fieldset для семантической группировки связанных элементов управления формы.
  • Используйте Separator для визуального разделения соседних областей.
  • Используйте Slot, когда композиция должна передавать пропсы одному дочернему элементу через asChild.
  • Используйте VisuallyHidden для содержимого, которое должно оставаться доступным вспомогательным технологиям, но не участвовать в визуальной раскладке.

По роли

  • Нейтральная поверхность для содержимого: Card
  • Семантическая группа формы: Fieldset
  • Визуальный разделитель: Separator
  • Помощник полиморфной композиции: Slot
  • Скрытое, но доступное содержимое: VisuallyHidden

Частые ошибки классификации

  • Не используйте Card, когда группировка должна быть нативной структурой формы; используйте Fieldset.
  • Не используйте Separator как единственное средство, задающее смысловое деление на разделы.
  • Не используйте Slot как стилизованную обёртку: это примитив композиции, а не поверхность.
  • Не используйте VisuallyHidden, чтобы скрыть содержимое, которое на самом деле должно быть убрано и от вспомогательных технологий.

С чего начать

  • Блоки дашбордов, разделы настроек, сводки: Card
  • Области со сгруппированными элементами управления: Fieldset
  • asChild и полиморфная композиция: Slot
  • Доступные скрытые подписи или описания: VisuallyHidden