FormOptions

Configuration options for form-level validation behavior.

This interface defines form-wide validation settings, particularly around pre-validation which allows the form to validate all fields and determine submission readiness before the user attempts to submit.

Usage:

val formOptions = FormOptions(
    preValidation = true,
    preValidationDelayOnMount = 300.milliseconds,
    preValidationDelayOnChange = 250.milliseconds
)

Inheritors

Default

Types

Default

object Default : FormOptions

Default form options with sensible defaults for most use cases.

Properties

preValidation

abstract val preValidation: Boolean

Whether to enable pre-validation of the entire form. When enabled, the form continuously validates all fields to determine if submission is allowed.

preValidationDelayOnChange

abstract val preValidationDelayOnChange: Duration

The delay before pre-validation is triggered when any field value changes. This helps prevent excessive validation calls during rapid form interactions.

preValidationDelayOnMount

abstract val preValidationDelayOnMount: Duration

The delay before pre-validation is triggered when fields are added or removed. This helps avoid excessive validation calls during field structure changes.