EventTypeDescription
select CustomEvent<MultiSelectEventDetail>An option was selected via the UI. detail.option, detail.selectedOptions, detail.selectedValues.
deselect CustomEvent<MultiSelectEventDetail>An option was deselected via the UI.
change CustomEvent<MultiSelectEventDetail>The selection set changed (no single option).
add v2.0.0 CustomEvent<MultiSelectEventDetail>The user committed the add-new prompt. detail.value is the typed text; detail.option is the created option if addNewCallback produced one.
ready v2.1.0 CustomEventFired once, right after the first build — synchronously during upgrade for a normal element, or when a defer gate is released for a deferred one. No detail.
Breaking change in v2.0.0: the onSelect/onDeselect/onChange handler properties now receive a CustomEvent (not a bare option). Read e.detail. The addEventListener path is unchanged. See Migration.

Event detail

MultiSelectEventDetail
 

Listening

addEventListener