Open in Playroom
Grouping is supported via native optgroup elements.
Open in Playroom
Supports all three levels of FieldLabel:
  • label — primary title of the field,
  • secondaryLabel — additional context, typically used to indicate optionality of a field,
  • tertiaryLabel — further context, typically used for providing assistance with a field.
 Help
Open in Playroom
A message is typically used to communicate the status of a field, such as an error message. This will be announced on focus of the field and can be combined with a tone to illustrate its purpose.The supported tones are: "critical", "positive", "caution", and "neutral".
Critical message
Positive message
Caution message
Neutral message
Open in Playroom
Additional context can be provided with a description. This will display below the field label and also be announced by a screen reader when the field is focused.
Extra information about the field
Open in Playroom
Mark the field as disabled by passing true to the disabled prop.
Open in Playroom
Providing a placeholder will display as a prompt to the user when no value is selected.
Open in Playroom
For decoration and help distinguishing between fields, an icon can be provided. This will be placed to the left of the field and is not interactive.
Open in Playroom
In some cases it may be necessary for a field to be labelled by another element or even not to have a visual label. Instead of providing a label either aria-label or aria-labelledby can be provided.

Custom field label

The label for this field is the Heading element before it.
The label for this field is hidden.
Open in Playroom