ListItem

A list item for displaying a label with optional subtext, left slot for custom content (e.g. an icon), and either a right chevron (link mode via href) or an inline action bar with quick actions and overflow menu (via actions).

When href is set, the entire row becomes a clickable link with a right chevron indicator.

Left Slot

Pass custom content into the left slot for an icon or any custom element on the left side.

Label Slot

Use the label slot for custom primary content (e.g. a title with muted metadata). When provided, it overrides the label prop.

Subtext Slot

Use the subtext slot for custom or multi-line secondary content. When provided, it overrides the subtext prop.

Action Mode

When actions is set, an action bar appears on the right side. Up to 2 visible actions are shown as quick action buttons. When more than 2 actions exist, only those marked with quickAction: true appear inline; the rest go into the ellipsis overflow menu. On desktop, quick actions are revealed on row hover.

Basic actions (with quickAction flags)

document.pdf
2.5 MB
image.png
1.2 MB

Many actions (overflow menu)

presentation.pptx
5.8 MB
spreadsheet.xlsx
890 KB

Single action

config.json
12 KB

Actions with href

Cloudron
cloudron.io

Usage

Action definition

API

Props

PropTypeDefaultDescription
labelString-Main label text (ignored when the label slot is used)
subtextString-Optional subtext below the label (ignored when the subtext slot is used)
hrefString-When set, renders as an <a> tag with a right chevron
actionsArray[]Action items for the inline action bar (mutually exclusive with href)

Action Item Properties

PropertyTypeDescription
labelStringItem label (shown in tooltip and overflow menu)
iconStringFontAwesome icon class for the button
actionFunctionClick handler
hrefStringRender as a link instead of a button
targetStringLink target (e.g. _blank)
quickActionBooleanShow this action in the quick actions bar. When <=2 visible actions exist, all are shown as quick actions regardless of this flag.
visibleBooleanShow or hide this action (default true)
separatorBooleanRender as a separator in the overflow menu
disabledBooleanDisable the action in the overflow menu
checkboxBooleanRender as a checkbox item in the overflow menu
checkedBooleanCheckBox checked state
typeComponentCustom Vue component for the menu item

Slots

SlotDescription
leftCustom content for the left side (e.g. an icon or a div)
labelCustom primary content. Overrides the label prop when used.
subtextCustom secondary content below the label. Overrides the subtext prop when used.