Skip to main content
Data DisplayLevel 1

List

列表

WebMobileDesktopDifficulty: Easy

A single column of stacked items, where every row is the same kind of thing and the whole row is one target.

01

Live Demo

Actually clickable
Each row is its own tap target. The whole row gives hover feedback — not just the text.

What you just saw:A WeChat conversation list, the rows inside Settings, the mail list on iOS — avatar on the left, title in the middle, timestamp on the right.

02

What it actually is

A list is the base unit of information display. The two decisions that matter are how much goes in one row and which rows are tappable. When a row is tappable, the entire row needs hover feedback and a full-row hit area.

listlist itemrowfeedstackcollection
03

Anatomy · What it's made of

  1. Row / Item列表行

    Minimum 48px hit area, the whole row is tappable

  2. Leading前导

    Avatar / icon

  3. Title主标题

    Truncated to one line

  4. Subtitle副标题

    Secondary color, one line

  5. Trailing尾部

    Value / timestamp / chevron

  6. Divider分隔线

    Aligned to the text, not full-bleed

04

When to Use

When it fits, and when it doesn't
List usage recommendations
SituationUse it?
Three or more similar items need vertical browsingYes
Every item has the same structure (title + subtitle + value)Yes
Users need to scan quicklyYes
Users need to compare values horizontally across itemsNo
There are only one or two itemsDepends

Once a row carries five fields it has become a table — use a Table for horizontal comparison.

Rows need a divider or vertical whitespace between them, otherwise they smear into one block.

05

Similar Patterns

Don't mix these up
06

How to tell AI

Three levels of prompt

Add the component name and specifics

Add a settings list: each row has a leading icon + title on the left, the current value + chevron on the right, the whole row is tappable, rows are separated by hairlines, and groups are separated by section headers.

07

Don't just say this to AI

Bad → Better

Don't say this to AI

Add a list to show the data.

Say this instead

Add a settings List: wrap each row in a button so the whole row is tappable, height >=48px, leading icon + title on the left, value + chevron on the right, dividers aligned to the text rather than full-bleed, and groups separated by headings plus spacing instead of dividers.

08

Share this card

Social-ready

Turn this pattern into a 3:4 or 1:1 knowledge card and export it as PNG right in the browser. No backend needed.