Form

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

События

• submit — payload: { event: Event, form: Record<string, unknown>, valid: true }. Срабатывает, когда валидация пройдена; form содержит собранные данные по именам полей.
• invalid — payload: Record<string, string | boolean>. Срабатывает при наличии ошибок валидации; передаётся карта ошибок по именам полей.
• reset — без payload. Срабатывает при сбросе формы.

Описание

Компонент C3Form — обёртка формы, которая собирает поля, выполняет валидацию при отправке и управляет состоянием ошибок. Поля, обёрнутые в C3FormField, автоматически регистрируются и проверяются при submit.

Используйте событие submit для обработки успешной отправки и invalid для реакции на ошибки валидации. События reset — для сброса ошибок.

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

• Слот по умолчанию — scoped-slot со свойствами: errors (карта ошибок), validate (функция валидации) и isValid (boolean).
• Через ref доступны методы: validate(), collect(), reset(), isValid и реактивное errors.
• Валидация учитывает сообщения ошибок из пропа error полей и обязательность required с проверкой пустого значения.
• Данные формы собираются из зарегистрированных полей по их пропу name.