Skip to content

Dropdown Item ​

SCADropdownItem is one row of a SCADropdown menu: a label with an optional icon, avatar, caption and a leading check, checkbox, radio or toggle. Icon names are typed (IconName); see Icons.

Props ​

PropTypeDefaultDescription
labelstring—Row text (or use the label / tag slot). Required.
type'selectable' | 'checkbox' | 'radio' | 'action' | 'toggle' | 'dropdowntarget'—What sits before the label. selectable shows a check while selected and toggles selected on click; checkbox, radio and toggle render that control and follow checked; action and toggle rows get the pointer cursor.
selectedbooleanfalseselectable state. Two-way via v-model:selected.
checkedbooleanfalseState of the checkbox, radio and toggle types.
iconIconName—Icon before the label.
iconSizestring'20px'Size of the icon and of the expand caret.
avatarInitialsstring—Show an avatar with these initials (or fill the avatar slot).
captionstring—Secondary text.
captionPosition'horizontal' | 'vertical''horizontal'Caption right of the label, or below it.
expandablebooleanfalseShow a caret-right for a sub-menu.
disabledbooleanfalseDisabled; swallows clicks.
activebooleanfalseHighlighted (e.g. keyboard focus).
useSmallerVerticalPadding / useSmallPadding / useHigherOptionbooleanfalseDensity variants.
unsetAll / unsetGapbooleanfalseDrop the item's own padding / gap.
useNeutralIconFillbooleanfalsePaint every svg inside the item neutral grey, overriding icon colours set on them. A selected item still paints them blue.

Slots ​

SlotDescription
defaultThe native control for checkbox / radio types.
label / tagReplace the label text (tag wins).
avatarAvatar content (an image) inside the initials avatar.

The item has no emits of its own: listen to @click on it, and to update:selected for selectable.

Selectable ​

Checkbox ​

Radio ​

Action, toggle and states ​

Icon size ​