Dropdown multiselect

Present a list of options to the user to select multiple values from.

Props

name
string
Identifier for the group. Used in change events.
ariaLabel
string
Provides an accessible label when no visible label is associated.
ariaLabelledBy
string
References an external element that labels this component.
disabled
boolean
Disables the component.
error
boolean
Shows an error state.
filterable
boolean
Enables filtering of options by typing in the trigger.
maxHeight
string
Sets the maximum height of the dropdown content area.
Defaults to 276px.
placeholder
string
Text shown when nothing is selected.
selectAll
boolean
Shows a "Select All" checkbox at the top of the options list.
size
GoabDropdownMultiselectSize
Sets the size variant.
Defaults to default.
testId
string
Sets a data-testid attribute for automated testing.
truncateLabel
boolean
When true the display label shows a truncated "n items" in the label.
value
string[]
Array of currently selected checkbox value.
width
string
Sets a fixed width for the component and popover panel.
mt, mr, mb, ml
Spacing
Apply margin to the top, right, bottom, and/or left of the component.
name
string
Identifier for the group. Used in change events.
ariaLabel
string
Provides an accessible label when no visible label is associated.
ariaLabelledBy
string
References an external element that labels this component.
disabled
boolean
Sets the disabled state for the control.
error
boolean
Sets the error state for the control.
filterable
boolean
Enables filtering of options by typing in the trigger.
id
string
Sets the id attribute of the underlying web component.
maxHeight
string
Sets the maximum height of the dropdown content area.
placeholder
string
Text shown when nothing is selected.
selectAll
boolean
Shows a "Select All" checkbox at the top of the options list.
size
GoabDropdownMultiselectSize
Sets the size variant.
Defaults to default.
testId
string
Sets the data-testid attribute for automated testing.
truncateLabel
boolean
When true the display label shows a truncated "n items" in the label.
value
string[]
Array of currently selected checkbox value.
width
string
Sets a fixed width for the component and popover panel.
mt, mr, mb, ml
Spacing
Apply margin to the top, right, bottom, and/or left of the component.
name
string
Identifier for the group. Used in change events.
arialabel
string
Provides an accessible label when no visible label is associated.
arialabelledby
string
References an external element that labels this component.
disabled
boolean true | false
Disables the component.
Defaults to false.
error
boolean true | false
Shows an error state.
Defaults to false.
filterable
boolean true | false
Enables filtering of options by typing in the trigger.
Defaults to false.
maxheight
string
Sets the maximum height of the dropdown content area.
Defaults to 276px.
placeholder
string
Text shown when nothing is selected.
select-all
boolean true | false
Shows a "Select All" checkbox at the top of the options list.
Defaults to false.
size
"default" | "compact"
Sets the size variant.
Defaults to default.
testid
string
Sets a data-testid attribute for automated testing.
truncate-label
boolean true | false
When true the display label shows a truncated "n items" in the label.
Defaults to false.
value
string[]
Array of currently selected checkbox values.
Defaults to [].
width
string
Sets a fixed width for the component and popover panel.
mt, mr, mb, ml
Spacing
Apply margin to the top, right, bottom, and/or left of the component.

Events

onChange
(detail: GoabDropdownMultiselectOnChangeDetail) => void
Callback fired when the selected value change.
onChange
(event: GoabDropdownMultiselectOnChangeDetail) => void
Emits when the selected value change.
_change
CustomEvent<{ name: string; value: string[]; labels: string[] }>
value
string
The value submitted when this item is selected.
filter
string
Text used to filter and match this item in typeahead search.
label
string
Display label for the dropdown item.
mountType
GoabDropdownItemMountType
Controls how the item is registered with the parent dropdown.
testId
string
Sets a data-testid attribute for automated testing.
filter
string
Text used to filter and match this item in typeahead search.
label
string
Display label for the dropdown item.
mountType
GoabDropdownItemMountType
Controls how the item is registered with the parent dropdown.
name
string
Sets the name attribute of the dropdown item.
value
string
The value submitted when this item is selected.
filter
string
Text used to filter and match this item in typeahead search.
label
string
Display label for the dropdown item.
mount
"append" | "prepend" | "reset"
Controls how the item is registered with the parent dropdown.
Defaults to reset.
value
string
The value submitted when this item is selected.
Examples
Examples show common usage patterns and implementation guidance.

No usage guidelines have been documented for this component yet.

All GoA Design System components are built to meet WCAG 2.2 AA standards. The following guidelines provide additional context for accessible implementation.

No accessibility-specific guidelines have been documented for this component yet.

View old component docs