Skip to content

Select ​

SCASelect is a single-choice dropdown with a label, helper text and optional search, built from SCAInputWrapper and a trigger input. Icon names are typed (IconName); see Icons.

Props ​

PropTypeDefaultDescription
modelValuestring | number—id of the selected item. v-model.
itemsSelectableItem[]—Options. Required.
labelstring—Label.
labelPosition'top' | 'left' | 'hidden'—Where the label sits.
appearance'border' | 'typo-header-xlarge' | 'no-border' | 'bottom-border'—Trigger style.
placeholderstring—Text while nothing is selected.
iconIconName—Icon at the start of the trigger.
search'client' | 'custom'—Make the trigger searchable: client filters by label, custom leaves filtering to you.
searchTermstring''Search text. v-model:search-term.
required / optionalLabelTextboolean / stringfalse / —Required mark, or the text of the optional hint.
helperTextstring | Ref<string>—Text under the field.
validationErrorbooleanfalseShow helperText as an error.
alertbooleanfalseAlert (error) underline without a message.
disabledbooleanfalseDisable the field.
htmlForstring—id of the trigger input, for an external <label>.
tooltip / helpLinkstring—Label tooltip / help link.
hidePopoverOnValueChangebooleantrueClose the list after a choice.
hasMore / loadingMorebooleanfalsePaged lists: more items exist / loading them.
itemIconSizestring—Size of the item icons.
useSmallerVerticalPaddingbooleanfalseDenser items.
disableHoverColorTagbooleanfalseNo hover colour on the coloured closed tag.
truncateClosedTagbooleanfalseTruncate a long closed tag.
noMobileMarginbooleanfalseDrop the mobile bottom margin.

SelectableItem ​

FieldTypeDescription
idstring | numberValue.
labelstringText.
iconIconNameIcon before the label.
avatarInitialsstringAvatar before the label.
colorStatusColorShow the item as a coloured tag (status).
hiddenbooleanLeft out of the list.
disabledbooleanListed but not selectable.

Emits ​

EventPayloadWhen
update:modelValuestring | numberAn item is chosen.
update:searchTermstringThe search text changes.
opened / closed—The list opens / closes.
loadMore—The end of the list is reached while hasMore.

Slots ​

SlotDescription
triggerContentReplace the selected value in the trigger (item: the selected item).
tagRender each item (item) as a tag.
input / afterExtra content inside the trigger.

Item Objects ​

Placeholder ​

Preselected Item ​

Icon ​

Item icons, avatars and disabled items ​

Required ​

Disabled ​

HTML for ​

search = client ​

Filters the items automaticaly in the component itself by the search term

search = custom ​

Ignores filtering the items. Use the v-model:search-termto filter the items by hand.

Helper Text ​

hidePopoverOnValueChange (default: true) ​

Prevents the popover from hiding after clicking on an option.