FormField
Подпись, подсказка и обязательность
Как к вам обращаться
Ошибка через проп
Некорректный адрес
Размеры
Размер обёртки применяется к полям, которые не задали свой. Собственный size поля важнее обёртки и переопределяет его.
Обёртка sm, но поле с собственным lg
Кастомная подпись слотом
Выберите один вариант
Входные параметры
| Имя | Тип | По умолчанию | Описание |
|---|---|---|---|
label | string | undefined | Подпись поля. |
name | string | undefined | Имя поля — ключ в данных формы и для id поля. |
hint | string | undefined | Вспомогательный текст под полем. |
error | string | boolean | false | Сообщение об ошибке; false — ошибки нет. |
required | boolean | false | Маркер обязательности (добавляет «*» и проверку при валидации). |
size | FieldSize ('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не объявляются.