Appearance
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
| Prop | Type | Default | Description |
|---|---|---|---|
label | string | — | 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. |
selected | boolean | false | selectable state. Two-way via v-model:selected. |
checked | boolean | false | State of the checkbox, radio and toggle types. |
icon | IconName | — | Icon before the label. |
iconSize | string | '20px' | Size of the icon and of the expand caret. |
avatarInitials | string | — | Show an avatar with these initials (or fill the avatar slot). |
caption | string | — | Secondary text. |
captionPosition | 'horizontal' | 'vertical' | 'horizontal' | Caption right of the label, or below it. |
expandable | boolean | false | Show a caret-right for a sub-menu. |
disabled | boolean | false | Disabled; swallows clicks. |
active | boolean | false | Highlighted (e.g. keyboard focus). |
useSmallerVerticalPadding / useSmallPadding / useHigherOption | boolean | false | Density variants. |
unsetAll / unsetGap | boolean | false | Drop the item's own padding / gap. |
useNeutralIconFill | boolean | false | Paint every svg inside the item neutral grey, overriding icon colours set on them. A selected item still paints them blue. |
Slots
| Slot | Description |
|---|---|
default | The native control for checkbox / radio types. |
label / tag | Replace the label text (tag wins). |
avatar | Avatar 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.