FormField

Подпись, подсказка и обязательность

Как к вам обращаться

Ошибка через проп

Размеры

Размер обёртки применяется к полям, которые не задали свой. Собственный size поля важнее обёртки и переопределяет его.

Обёртка sm, но поле с собственным lg

Кастомная подпись слотом

Выберите один вариант

Входные параметры

ИмяТипПо умолчаниюОписание
labelstringundefinedПодпись поля.
namestringundefinedИмя поля — ключ в данных формы и для id поля.
hintstringundefinedВспомогательный текст под полем.
errorstring | booleanfalseСообщение об ошибке; false — ошибки нет.
requiredbooleanfalseМаркер обязательности (добавляет «*» и проверку при валидации).
sizeFieldSize ('sm' | 'md' | 'lg')'md'Размер поля по умолчанию для вложенных контролов. Используется, только если контрол не задал свой size.

Описание

Компонент C3FormField — обёртка одного поля формы: подпись, обязательность, подсказка и сообщение об ошибке. Он предоставляет контекст дочернему контролу (C3Input, C3Select и др.) через инъекцию, передавая id, размер, флаг обязательности и ошибку.

Оберните контрол в C3FormField для согласованной подписи и связи с C3Form: поле автоматически регистрируется для сбора данных и валидации при отправке.

Дополнительная информация

  • Слот по умолчанию #default — дочерний контрол (инпут, селект и т. п.).
  • Слот #label — кастомное содержимое подписи вместо пропа label.
  • При required выводится маркер «*», а при пустом значении возвращается ошибка «Поле обязательно для заполнения».
  • Ошибка отображается в элементе с ролью alert; подсказка hint скрывается при наличии ошибки.
  • id генерируется как c3-field-{name}, а если имя не задано — как c3-field-{vue useId}. Значение детерминировано между сервером и клиентом, поэтому SSR-разметка совпадает при гидрации.
  • События: явные emit не объявляются.
×