FormConfig

Array of field definitions that define the form structure.

Fields are rendered in the order they appear in this array. Supports nested groups and conditional field visibility.

Optional form-level validation schema using Standard Schema spec.

Provides additional validation beyond field-level validation. Supports Zod, Valibot, ArkType, and other Standard Schema compliant libraries. Useful for cross-field validation rules.

Global form configuration options.

Controls form-wide behavior like validation timing and disabled state.

@value {}

Global schemas available to all fields.

Reusable validation schemas that can be referenced by field definitions. Promotes consistency and reduces duplication.

Form-level validation messages that act as fallback for field-level messages.

These messages are used when a field has validation errors but no field-level validationMessages are defined for that specific error. This allows you to define common validation messages once at the form level instead of repeating them for each field.

Form submission configuration.

When provided, enables integration with Angular Signal Forms' native submit() function. The submission mechanism is optional - you can still handle submission manually via the (submitted) output if you prefer.

While the submission action is executing, form().submitting() will be true, which automatically disables submit buttons (unless configured otherwise).

Server errors returned from the action will be automatically applied to the corresponding form fields.

Default props applied to all fields in the form.

These props serve as defaults that can be overridden at the field level. Useful for setting consistent styling across the entire form (e.g., appearance, size, or other UI library-specific props).

The cascade order is: Library config → Form defaultProps → Field props Each level can override the previous one.

External data signals available to conditional logic and derivations.

Provides a way to inject external application state into form expressions. Each property is a Signal that will be unwrapped and made available in the EvaluationContext under externalData.

The signals are read reactively in logic functions (when/readonly/disabled) so changes to the external data will trigger re-evaluation of conditions.

Form-wide default wrappers applied to every field that does not explicitly opt out.

Merged into a field's effective wrapper chain between auto-associated wrappers (outermost) and field-level wrappers (innermost). Fields with wrappers: null opt out entirely — no defaults, no auto-associations.