The v-list component is used to display information. It can contain an avatar, content, actions, subheaders and much more. Lists present content in a way that makes it easy to identify a specific item in a collection. They provide a consistent styling for organizing groups of text and images.

Usage

Lists come in three main variations. single-line (default), swo-line and three-line. The line declaration specifies the minimum height of the item and can also be controlled from v-list with the same prop.

API

v-list

Examples

Avatar with title and action

Lists also contain slots for a more explicit approach. If you choose this approach, remember you must provide additional props for correct spacing. In this example, we have a tile with an avatar, so we must provide an avatar property.

Icon with 2 lines and action

Lists can contain subheaders, dividers, and can contain 1 or more lines. The subtitle will overflow with ellipsis if it extends past one line.

Avatar with 3 lines

For three line lists, the subtitle will clamp vertically at 2 lines and then ellipsis.

Avatar with title and action

Here we combine v-list-item-avatar and v-list-item-icon in a single-line list.

Subheadings and dividers

Lists can contain multiple subheaders and dividers.

Card image with toolbar and list

A list can be combined with a card.

Title with sub-title, actions and action-text

A list can contain a stack within an action. This is useful when you need to display meta text next to your action item.

Action with title and sub-title

A three-line list with actions. Utilizing v-list-item-group, easily connect actions to your tiles.

Expansion Lists

A list can contain a group of items which will display on click. Expansion lists are also used within the v-navigation-drawer component.

Lists can receive an alternative nav styling that reduces the width v-list-item takes up as well as adding a border radius.

Shaped lists

Shaped lists have rounded borders on one side of the v-list-item.

Edit this page | language on Github