role combobox
Select draft v0.1.0
Lets people choose one option from a list that opens on demand.
A select shows the current choice in a closed box and opens a list of options when activated; the browser or the platform renders the list, its keyboard interaction and its announcements. It fits a choice among many known values (a country, a time zone, a sort order) where showing every option at once would take too much room. Two to about six options worth reading side by side are a Radio group; a list of actions is a Dropdown.
Playground
Token inspector
Part container
Not rendered in this configuration.
-
gap from default
{space.4}Details
- Value
-
4px - CSS
--select-container-gap- Token
select.container.gap
Part label
Not rendered in this configuration.
-
color
defaultfrom default{global.text.on-base.neutral.primary}Details
- Resolves through
light-switch.base.950 rawneutral.light.ash.950 raw- Value
-
#0E0D0Ddark:#D2CECF - CSS
--select-label-color-default- Token
select.label.color.default
-
color
disabledfrom default{global.text.state.disabled.default}Details
- Resolves through
light-switch.base.500 rawneutral.light.ash.500 raw- Value
-
#8C8C8Cdark:#9D9B9Cb2 - CSS
--select-label-color-disabled- Token
select.label.color.disabled
-
typography from default
Details
- Value
-
Inter [object Object]/1.5 500 [object Object] - CSS
--select-label-typography-font-family- Token
select.label.typography
Part field
Not rendered in this configuration.
No tokens of its own: it inherits from its parent.
Part control
Not rendered in this configuration.
-
min-height
smallfrom default{space.32}Details
- Value
-
32px - CSS
--select-control-min-height-small- Token
select.control.min-height.small- Decisions
-
min-height
mediumfrom default{space.40}Details
- Value
-
40px - CSS
--select-control-min-height-medium- Token
select.control.min-height.medium- Decisions
-
min-height
largefrom default{space.48}Details
- Value
-
48px - CSS
--select-control-min-height-large- Token
select.control.min-height.large- Decisions
-
padding-inline
smallfrom default{space.8}Details
- Value
-
8px - CSS
--select-control-padding-inline-small- Token
select.control.padding-inline.small- Decisions
-
padding-inline
mediumfrom default{space.12}Details
- Value
-
12px - CSS
--select-control-padding-inline-medium- Token
select.control.padding-inline.medium- Decisions
-
padding-inline
largefrom default{space.16}Details
- Value
-
16px - CSS
--select-control-padding-inline-large- Token
select.control.padding-inline.large- Decisions
-
border-radius from default
{corner-radius.xs}Details
- Value
-
4px - CSS
--select-control-border-radius- Token
select.control.border-radius- Decisions
-
border-width from default
{stroke-width.sm}Details
- Value
-
0.6px - CSS
--select-control-border-width- Token
select.control.border-width- Decisions
-
background
defaultfrom default{global.bg.level.0.default}Details
- Resolves through
global.bg.base.neutral.1 semanticlight-switch.base.25 rawneutral.light.ash.25 raw- Value
-
#FDFDFDdark:#191919 - CSS
--select-control-background-default- Token
select.control.background.default- Decisions
-
background
hoverfrom default{global.bg.level.0.hover}Details
- Resolves through
global.bg.base.neutral.2 semanticlight-switch.base.50 rawneutral.light.ash.50 raw- Value
-
#F7F6F6dark:#212121 - CSS
--select-control-background-hover- Token
select.control.background.hover- Decisions
-
background
disabledfrom default{global.bg.state.disabled.default}Details
- Value
-
#B6B4B41adark:#7676764d - CSS
--select-control-background-disabled- Token
select.control.background.disabled- Decisions
-
border-color
defaultfrom default{global.border.accent.neutral.default}Details
- Resolves through
light-switch.base.800 rawneutral.light.ash.800 raw- Value
-
#323031dark:#B9B7B7 - CSS
--select-control-border-color-default- Token
select.control.border-color.default- Decisions
-
border-color
invalidfrom default{global.border.base.functional.error.default}Details
- Resolves through
functional.error.600 raw- Value
-
#C01619dark:#E12A23 - CSS
--select-control-border-color-invalid- Token
select.control.border-color.invalid- Decisions
-
border-color
disabledfrom default{global.border.state.disabled.default}Details
- Value
-
#B6B4B466dark:#363636b2 - CSS
--select-control-border-color-disabled- Token
select.control.border-color.disabled- Decisions
-
color
defaultfrom default{global.text.on-base.neutral.primary}Details
- Resolves through
light-switch.base.950 rawneutral.light.ash.950 raw- Value
-
#0E0D0Ddark:#D2CECF - CSS
--select-control-color-default- Token
select.control.color.default- Decisions
-
color
disabledfrom default{global.text.state.disabled.default}Details
- Resolves through
light-switch.base.500 rawneutral.light.ash.500 raw- Value
-
#8C8C8Cdark:#9D9B9Cb2 - CSS
--select-control-color-disabled- Token
select.control.color.disabled- Decisions
-
typography
smallfrom defaultDetails
- Value
-
Inter [object Object]/1.5 400 [object Object] - CSS
--select-control-typography-small-font-family- Token
select.control.typography.small- Decisions
-
typography
mediumfrom defaultDetails
- Value
-
Inter [object Object]/1.5 400 [object Object] - CSS
--select-control-typography-medium-font-family- Token
select.control.typography.medium- Decisions
-
typography
largefrom defaultDetails
- Value
-
Inter [object Object]/1.5 400 [object Object] - CSS
--select-control-typography-large-font-family- Token
select.control.typography.large- Decisions
-
outline-width
focus-visiblefrom default{focus.ring.width}Details
- Resolves through
stroke-width.lg semantic- Value
-
2.4px - CSS
--select-control-outline-width-focus-visible- Token
select.control.outline-width.focus-visible
-
outline-offset
focus-visiblefrom default{focus.ring.offset}Details
- Resolves through
space.4 semantic- Value
-
4px - CSS
--select-control-outline-offset-focus-visible- Token
select.control.outline-offset.focus-visible
-
outline-color
focus-visiblefrom default{color.focus.ring}Details
- Resolves through
brand.light.600 raw- Value
-
#175DD6dark:#9EE7FA - CSS
--select-control-outline-color-focus-visible- Token
select.control.outline-color.focus-visible
-
transition.duration from default
{duration.fast}Details
- Value
-
150ms - CSS
--select-control-transition-duration- Token
select.control.transition.duration
-
transition.easing from default
{easing.standard}Details
- Value
-
cubic-bezier(0.2, 0, 0, 1) - CSS
--select-control-transition-easing- Token
select.control.transition.easing
-
padding-inline-end
smallfrom default{space.28}Details
- Value
-
28px - CSS
--select-control-padding-inline-end-small- Token
select.control.padding-inline-end.small- Decisions
-
padding-inline-end
mediumfrom default{space.36}Details
- Value
-
36px - CSS
--select-control-padding-inline-end-medium- Token
select.control.padding-inline-end.medium- Decisions
-
padding-inline-end
largefrom default{space.40}Details
- Value
-
40px - CSS
--select-control-padding-inline-end-large- Token
select.control.padding-inline-end.large- Decisions
Part indicator
Not rendered in this configuration.
-
font-family from default
{font.icon.family}Details
- Value
-
"Material Symbols Outlined" - CSS
--select-indicator-font-family- Token
select.indicator.font-family- Decisions
-
font-weight from default
{font.icon.weight.light}Details
- Value
-
300 - CSS
--select-indicator-font-weight- Token
select.indicator.font-weight- Decisions
-
fill from default
{font.icon.fill.off}Details
- Value
-
0 - CSS
--select-indicator-fill- Token
select.indicator.fill- Decisions
-
grade from default
{font.icon.grade.normal}Details
- Value
-
0 - CSS
--select-indicator-grade- Token
select.indicator.grade- Decisions
-
optical-size from default
{font.icon.optical-size.20}Details
- Value
-
20 - CSS
--select-indicator-optical-size- Token
select.indicator.optical-size- Decisions
-
size
smallfrom default{size.2}Details
- Value
-
16px - CSS
--select-indicator-size-small- Token
select.indicator.size.small- Decisions
-
size
mediumfrom default{size.3}Details
- Value
-
20px - CSS
--select-indicator-size-medium- Token
select.indicator.size.medium- Decisions
-
size
largefrom default{size.4}Details
- Value
-
24px - CSS
--select-indicator-size-large- Token
select.indicator.size.large- Decisions
-
margin-inline from default
{space.8}Details
- Value
-
8px - CSS
--select-indicator-margin-inline- Token
select.indicator.margin-inline- Decisions
Part option
Not rendered in this configuration.
No tokens of its own: it inherits from its parent.
Part description
Not rendered in this configuration.
-
color
defaultfrom default{global.text.on-base.neutral.secondary}Details
- Resolves through
light-switch.base.800 rawneutral.light.ash.800 raw- Value
-
#323031dark:#B9B7B7 - CSS
--select-description-color-default- Token
select.description.color.default
-
color
disabledfrom default{global.text.state.disabled.default}Details
- Resolves through
light-switch.base.500 rawneutral.light.ash.500 raw- Value
-
#8C8C8Cdark:#9D9B9Cb2 - CSS
--select-description-color-disabled- Token
select.description.color.disabled
-
typography from default
Details
- Value
-
Inter [object Object]/1.5 400 [object Object] - CSS
--select-description-typography-font-family- Token
select.description.typography
Part error-message
Not rendered in this configuration.
-
color from default
{global.text.on-base.functional.error.default}Details
- Resolves through
functional.error.500 raw- Value
-
#E12A23dark:#EE5248 - CSS
--select-error-message-color- Token
select.error-message.color
-
typography from default
Details
- Value
-
Inter [object Object]/1.5 500 [object Object] - CSS
--select-error-message-typography-font-family- Token
select.error-message.typography
<div class="ds-select" data-size="medium">
<label
class="ds-select__label"
data-part="label"
for="ds-select-23"
>Country</label>
<div class="ds-select__field" data-part="field">
<select
class="ds-select__control"
data-part="control"
id="ds-select-23"
>
<option
class="ds-select__option"
data-part="option"
value=""
disabled
selected
>Choose a country</option>
<option
class="ds-select__option"
data-part="option"
value="fr"
>France</option>
<option
class="ds-select__option"
data-part="option"
value="de"
>Germany</option>
<option
class="ds-select__option"
data-part="option"
value="es"
>Spain</option>
<option
class="ds-select__option"
data-part="option"
value="uk"
>United Kingdom</option>
</select>
<span
class="ds-select__indicator"
data-part="indicator"
aria-hidden="true"
>expand_more</span>
</div>
</div>