List Item Group

The "List Item Group" component uses a non interactive heading which groups list items.

Preview

Usage

Use this component when you have multiple list items you would like to group into different categories.

The heading is unstyled by default. You will likely have to pass utility classes to the heading-class prop to make the heading look how you wish.

Accessibility

The List Item Group does not implement arrow-keys keyboard navigation. You will however get arrow-keys keyboard navigation when using this within list based Dialtone components such as Dropdown or Combobox.

The aria label for the List Item Group will be set by the content of the heading.

Vue API

import { DtListItemGroup } from '@dialpad/dialtone-vue';

Slots

Name
Type
default

Slot for the list component

heading

Slot for heading, will override heading prop

Props

Name
Default
Type
heading
''
string

List's heading. Can also be overridden with a slot of the same name.

headingClass
''
string|array|object

Additional class to style the heading

id
generated unique ID
string

Id of the List Item Group

listClass
''
string|array|object

Additional class for the wrapper list element.

List Item Group documentation last updated Thursday, June 18, 2026