PropertyAttributeDescriptionTypeDefaultcompact compactDisplays as compact version.booleanfalsedescription descriptionThe description text.string''disabled disabledDisables the select.booleanfalsedropdownDirection dropdown-directionChanges the direction to which the dropdown list appears.type SelectDropdownDirection = 'down' 'up' 'auto''auto'filter filterShows an input in the dropdown allowing options to be filtered.booleanfalseform formThe id of a form element the select should be associated with.stringundefinedhideLabel 🛠hide-labelShow or hide label. For better accessibility it is recommended to show the label.boolean BreakpointCustomizable<boolean>falselabel labelThe label text.string''message messageThe message styled depending on validation state.string''name nameThe name of the control.stringundefinedrequired requiredA Boolean attribute indicating that an option with a non-empty string value must be selected.booleanfalsestate stateThe validation state.type SelectState = 'none' 'error' 'success''none'theme themeAdapts the select color depending on the theme.type Theme = 'light' 'dark' 'auto''light'value valueThe selected value.stringundefined
Events
prev
next
EventDescriptionTypeblur Emitted when the select has lost focus.CustomEvent<void>change Emitted when the selection is changed.type SelectChangeEventDetail = { name: string; value: string; } CustomEvent<SelectChangeEventDetail>update 🚫deprecated since v3.30.0, will be removed with next major release, use change event instead. Emitted when the selection is changed.type SelectUpdateEventDetail = { name: string; value: string; } CustomEvent<SelectUpdateEventDetail>
Slots
prev
next
SlotDescriptionisRequiredaltPropallowedTagNames<slot name="label"> Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed.<slot name="description"> Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed.<slot> Default slot for the `p-select-option` tags.<slot name="message"> Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed.
CSS Variables
prev
next
CSS VariableDescriptiondefaultValue--p-hyphens Sets the CSS `hyphens` property for text elements, controlling whether words can break and hyphenate automatically.auto
PropertyAttributeDescriptionTypeDefaultdisabled disabledDisables the option.booleanfalsevalue valueThe option value.stringundefined
Slots
prev
next
SlotDescriptionisRequiredaltPropallowedTagNames<slot> Default slot for the option content.
CSS Variables
prev
next
CSS VariableDescriptiondefaultValue--p-hyphens Sets the CSS `hyphens` property for text elements, controlling whether words can break and hyphenate automatically.auto