Components

List

Display grouped items with UiListGroup and UiListItem.

UiListGroup wraps UiListItem entries. Make items interactive for navigation or selection.

Add a list

<template>
  <UiListGroup>
    <UiListItem title="Inbox" text="12 new" icon="&#xe156;" />
    <UiListItem title="Drafts" icon="&#xe254;" />
    <UiListItem title="Archive" icon="&#xe149;" disabled />
  </UiListGroup>
</template>

Make it interactive

<template>
  <UiListGroup is-interactive variant="flush" size="sm">
    <UiListItem title="Profile" active />
    <UiListItem title="Billing" />
  </UiListGroup>
</template>

UiListGroup props

PropTypeDefaultDescription
variant'flush' | 'low-contrast'Surface style.
size'sm' | 'md'Item size.
isInteractivebooleanfalseHover / active styles.
isUndecoratedbooleanfalseHide the interactive arrow indicator.
customClassstring | string[] | Record<string, boolean> | nullExtra classes.

UiListItem props

PropTypeDefaultDescription
titlestring | nullPrimary text.
textstring | nullSupporting text.
iconstring | nullLeading Material Symbols code.
activebooleanfalseActive styling.
disabledbooleanfalseDisable the item.
hasActionsbooleanfalseLayout for trailing actions.
Copyright © 2026