DEVELOPER REFERENCE · v4.0.0

DropdownPopup API

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

DropdownPopup12 props2 callbacks0 methods

DropdownPopup props
Name	Type	Description
`triggerRef`Required	`RefObject<HTMLDivElement>`Inspect type	Reference to the element that anchors the dropdown popup.
`children`Required	`ComponentChildren`Inspect type	Content rendered inside the component. Supply nodes from the framework adapter you are using.
`portalTarget`Optional	`HTMLElement \| null \| undefined`Inspect type	DOM element into which the popup is mounted; omitted values use the component default.
`theme`Optional	`string \| null \| undefined`	Theme applied to popup content so it matches its surrounding application.
`dropdownMenuId`Optional	`string \| undefined`	ID assigned to the mounted dropdown menu.
`popupClassName`Optional	`string \| undefined`	Additional CSS classes for the popup part of the component.
`closeOnClickOutside`Optional	`boolean \| undefined`	Closes the dropdown popup when a pointer interaction occurs outside it.
`align`Optional	`"start" \| "end" \| undefined`	Aligns the popup to the start or end of its trigger.
`matchTriggerWidth`Optional	`boolean \| undefined`	Makes the dropdown popup match the trigger width.
`maxHeight`Optional	`number \| undefined`	Maximum popup height in pixels before its content scrolls.
`observePopupResize`Optional	`boolean \| undefined`	Repositions the popup when its size changes.
`topLayer`Optional	`boolean \| undefined`	Promotes the popup above modal dialogs without joining an ancestor's scroll context.

DropdownPopup events and callbacks
Name	Type	Description
`onPointerRelease`Optional	`((event: MouseEvent \| TouchEvent) => void) \| undefined`Inspect type	Handles the mouse/touch release associated with a popup interaction.
`onClose`Optional	`(() => void) \| undefined`Inspect type	Requests that the parent close the surface or picker.

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