enes

Dropdown Select New

import { DropdownSelect } from 'fluentui-svelte';

The Dropdown Select is a dropdown built on the native select element. It lets users choose one option, or several with the multiple prop, from a list of DropdownSelectOption children.

Browser compatibility

Custom styling uses appearance: base-select, ::picker(select) and <selectedcontent>. Single-select styling requires Chrome or Edge 135+, or Safari / iOS Safari 27+. Firefox (including 158) does not yet support the complete feature by default. Earlier Chrome / Edge and Safari versions use the native select appearance; rich option content and custom picker styling are unavailable.

Custom styling for multiple requires Chrome or Edge 145+. Safari / iOS Safari 27 and Firefox 158 do not support customizable listboxes and use the native listbox. Browser compatibility verified on October 16, 2026.

MDN: appearance · MDN: ::picker(select) · MDN: <selectedcontent>

Shape

Set shape to rounded (default), square, or circular.

Custom Option Content

Options can render rich content such as a Persona. Provide a text prop for the plain-text selection label.

Multiple Selection

Set the multiple prop to allow selecting more than one option at a time.

Form Control Attributes

Attributes and events apply to the native form field; ref gives you access to it. For the container, use wrapperAttributes and wrapperRef.

Component Props

NameTypeDefaultDescription
shape'circular' | 'rounded' | 'square''rounded'Shape of the input surface, including its border and focus indicator.
value bindablestring | string[]multiple ? [] : ''The selected value. An array of values when multiple is set.
multiplebooleanAllows more than one option to be selected at a time.
placeholderstring'Native Select Dropdown'The text shown while no option is selected.
hidePlaceholderbooleanKeeps the placeholder out of the option list once a value is selected.
ref bindableHTMLSelectElement | nullThe DOM reference of the select element.
wrapperRef bindableHTMLDivElement | nullThe DOM reference of the wrapper element.
wrapperAttributesHTMLAttributesThe attributes to spread on the wrapper element.
Element Attributes (select)

DropdownSelectOption Props

NameTypeDefaultDescription
valuestringThe value reported to the select when the option is picked.
textstringThe label of the option. Falls back to the rendered children.
disabledbooleanDisables the user interaction.
ref bindableHTMLElement | nullThe DOM reference of the option element.
childrenSnippetThe content of the option, used when no text is given.
Element Attributes (option)
Edit this Doc View as Markdown