FlattenedField

Additional CSS classes for custom styling.

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

Example usage

className: 'highlight required-field'
className: 'mt-4 text-center'

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.

Example usage

col: 12  // Full width
col: 6   // Half width
col: 4   // One third width
col: 3   // Quarter width

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 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

Guaranteed non-empty key for form binding and field identification

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.

Example usage

// Static string
label: 'Email Address'

// Translation key (auto-detected)
label: 'form.email.label'

// Observable from translation service
label: this.transloco.selectTranslate('form.email.label')

// Signal-based
label: computed(() => this.translations().email.label)

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.

Example usage

// Input field props
props: { placeholder: 'Enter email', type: 'email' }

// Select field props
props: { options: [{ label: 'Yes', value: true }], multiple: false }

// Button field props
props: { buttonType: 'submit', variant: 'primary' }

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

Tab index for keyboard navigation.

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

Example usage

tabIndex: 1    // First field in tab order
tabIndex: -1   // Excluded from tab navigation
tabIndex: 0    // Natural tab order

Field type identifier for component selection.

Determines which component will be rendered for this field. Must match a registered field type name in the field registry.

Example usage

type: 'input'     // Text input field
type: 'select'    // Dropdown selection
type: 'checkbox'  // Boolean checkbox
type: 'group'     // Field group container