24
Validation

Single-Field Validation

Validate one field without creating a submission.

Use this flow for real-time checks (blur/change) when you need to validate one input without submitting the whole form.

API signatures:

  • FormInstance::validateField(string $field, mixed $value, ?string $locale = null): array
  • FormManager::validateField(string $formKey, string $field, mixed $value, ?string $version = null, ?string $locale = null): array
  • ScopedFormManager::validateField(string $formKey, string $field, mixed $value, ?string $version = null, ?string $locale = null): array

Field identifier resolution:

  • $field accepts aliases: name, field_key, key, id
  • validation runs against the canonical field key name
  • if no alias matches a field, an UnknownFieldsException is thrown