DEVELOPER REFERENCE · v4.0.0

DropdownPopupContent API

Props, callbacks and methods. Select an underlined type to explore its fields, allowed values and callback arguments.

View selects, chips and resources examples →

DropdownPopupContent13 props3 callbacks0 methods

Props13

DropdownPopupContent props
Name	Type	Description
`options`Required	`DropdownOption<T>[]`Inspect type	Available choices or control configuration, according to the declared type; expand it to inspect each field.
`selectedValues`Optional	`DropdownOption<T>[] \| undefined`Inspect type	Selected option objects used to render the current dropdown selection.
`remote`Optional	`(RemoteDropdownState<T> & { text: DropdownRemoteText; search: (query: string) => void; loadMore: () => void; retry: () => void; }) \| undefined`Inspect type	Remote-option loading state and handlers for search, pagination and retry.
`value`Required	`T \| T[] \| undefined`Inspect type	Value to display or edit. The declared type identifies the supported representation; change callbacks describe how edited values are emitted.
`config`Required	`DropdownConfig<T>`Inspect type	Component configuration. Expand the type to see accepted fields and alternative forms.
`multiSelect`Required	`boolean`	Allows more than one option to be selected.
`search`Required	`boolean`	Shows the dropdown search field.
`searchPlaceholder`Required	`string`	Placeholder text in the search field.
`listboxId`Required	`string`	ID for the options listbox and its accessibility associations.
`searchId`Required	`string`	ID for the search field and its accessibility associations.
`renderOption`Optional	`((h: any, option: DropdownOption<T>, isSelected: boolean) => ComponentChildren) \| undefined`Inspect type	Custom renderer for an option and its current selection/disabled state.
`renderNoResults`Optional	`((h: any) => ComponentChildren) \| undefined`Inspect type	Custom renderer for an empty options list.
`theme`Optional	`string \| null \| undefined`	Theme applied to popup content so it matches its surrounding application.

Events and callbacks3

DropdownPopupContent events and callbacks
Name	Type	Description
`onChange`Required	`(value: T \| T[]) => void`Inspect type	Receives the new value when the user changes the control. Update the corresponding value prop for controlled use.
`onClose`Required	`(focusNext?: boolean) => void`Inspect type	Requests that the parent close the surface or picker.
`onTabNavigation`Optional	`(() => void) \| undefined`Inspect type	Called when Tab should leave the dropdown and continue normal focus navigation.

Methods0

No component-specific imperative methods. Use props and callbacks to control this component.