MatToggleField

Placeholder text displayed when the field is empty. Supports static strings, Observables, and Signals for dynamic content.

Unique field identifier used for form binding and value tracking.

This key is used to associate the field with form values and must be unique within the form. It follows object property naming conventions.

Human-readable field label displayed to users.

Provides accessible labeling for form fields and is typically displayed above or beside the field input. Supports static strings, translation keys, Observables, and Signals for dynamic content.

Field-specific properties and configuration options.

Contains type-specific configuration that varies based on the field type. The shape is defined by the TProps generic parameter.

Native HTML attributes to pass through to the underlying element.

Contains attributes that are applied directly to the native input/element. Useful for accessibility, autocomplete hints, and custom attributes. The shape is defined by the TMeta generic parameter, which extends FieldMeta.

Additional CSS classes for custom styling.

Space-separated string of CSS class names that will be applied to the field container for custom styling.

Whether the field is disabled and cannot be interacted with.

When true, the field is rendered in a disabled state and cannot receive user input. The value can still be modified programmatically.

@value false

Whether the field is read-only.

When true, the field displays its value but cannot be modified by user interaction. Differs from disabled in styling and accessibility.

@value false

Whether the field is hidden from view.

When true, the field is not rendered in the UI but still participates in form state and validation. Useful for conditional field display.

@value false

Tab index for keyboard navigation.

Controls the order in which fields receive focus when navigating with the Tab key. Follows standard HTML tabindex behavior.

Whether to exclude this field's value from submission output when hidden.

Overrides both the global withValueExclusionDefaults() and form-level FormOptions settings.

Whether to exclude this field's value from submission output when disabled.

Overrides both the global withValueExclusionDefaults() and form-level FormOptions settings.

Whether to exclude this field's value from submission output when readonly.

Overrides both the global withValueExclusionDefaults() and form-level FormOptions settings.

Column sizing configuration for responsive grid layout.

Specifies how many columns this field should span in a 12-column grid system. Supports responsive behavior and field arrangement.

Wrapper components to chain around this field.

- undefined — inherit auto-associations + form defaults. - null — render bare (see skipAuto/skipDefaults for partial opt-out). - readonly WrapperConfig[] — merged innermost with auto + defaults. - [] is not an opt-out; inherits like undefined.

Skip the auto-association layer (WrapperTypeDefinition.types) while keeping form-level defaults and any field-level wrappers. Use when a global wrapper auto-applies to this field type but isn't wanted here.

Skip the form-level defaultWrappers layer while keeping auto-associations and any field-level wrappers.

Shorthand for simple computed/derived fields.

The expression is evaluated whenever its dependencies change, and the result is set as this field's value.

Has access to formValue object containing all form values. Uses the same secure AST-based parser as other expressions.

For conditional derivations or derivations targeting other fields, use the full logic array with { type: 'derivation', ... }.