MaterialConfig
Configuration options for Material Design form fields.
These settings can be applied at two levels:
- Library-level: Via
withMaterialFields ({ ... }) - Form-level: Via
defaultPropsin form config - applies to a specific form
The cascade hierarchy is: Library-level → Form-level → Field-level
Properties
| Name | Type | Description |
|---|---|---|
| appearance | MatFormFieldAppearance | undefined | Default appearance for Material form fields @default 'outline' |
| color | ThemePalette | Default color theme for form controls (checkboxes, radios, sliders, toggles) @default 'primary' |
| disableRipple | boolean | undefined | Whether to disable ripple effects by default @default false |
| labelPosition | "before" | "after" | undefined | Default label position for checkboxes and radios @default 'after' |
| subscriptSizing | SubscriptSizing | undefined | Default subscript sizing for Material form fields @default 'dynamic' |
Example usage
// Library-level (in app config)
provideDynamicForms(withMaterialFields ({ appearance: 'outline' }))
// Form-level (in form config)
const config: MatFormConfig = {
defaultProps: { appearance: 'fill' },
fields: [...]
};