List

Lists are continuous, vertical indexes of text and images.

List

Usage

AppleBanana A yellow tropical fruitCherry SeasonalDurian
<md-list style="width: 280px">
  <md-list-item>Apple</md-list-item>
  <md-list-item>
    Banana
    <span slot="supporting-text">A yellow tropical fruit</span>
  </md-list-item>
  <md-list-item>
    Cherry
    <span slot="trailing-supporting-text">Seasonal</span>
  </md-list-item>
  <md-list-item>Durian</md-list-item>
</md-list>

Events

NameTypeDescription
selectListSelectEventFired when a list item has been selected.
item-focusListItemFocusEventFired when a list item is focused.

List Item

Slots

NameDescription
(default)The primary label text of the item.
startContent placed at the start of the item (e.g. icon).
endContent placed at the end of the item.
overlineSmall text displayed above the primary label.
headlineAlternative slot for the primary label text.
supporting-textSecondary descriptive text below the primary label.
trailing-supporting-textShort text or metadata displayed at the trailing end.

Properties

NameTypeDefaultDescription
selectedBooleanfalseWhether the list item is selected.
disabledBooleanfalseWhether the list item is disabled.