跳到主要内容
前端术语库

列表

List

UI 组件也叫:List View、列表视图、条目列表、清单

一句话:把多条内容纵向一条接一条排列,每条通常是标题加一两行说明,适合逐条浏览和点击进入详情。

详细解释

列表把多条内容竖着排成一列,每条占一行或几行。常见结构是左边一个图标或头像,中间标题和一行说明,右边时间、箭头或操作按钮。消息、通知、评论、文件列表、设置项都属于这一类。

列表和表格的区别在于字段数量和用途:列表每条只露出少量关键信息,重在从上到下逐条浏览、点进去看详情;表格按列对齐多个字段,重在横向比较和批量处理。列表和卡片的区别在于密度:列表紧凑,一屏能看很多条;卡片更占空间,适合以图片为主的内容。

条目较多时,列表常配合分页、无限滚动或「加载更多」按钮使用。

示例

灰度线框示意,只表达结构,不代表具体视觉风格。

怎么跟 AI 说

可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。

做一个消息通知列表,每条高 64px:左侧 40px 圆形头像,中间上行是加粗标题,下行是灰色单行摘要,超出部分省略;右侧显示相对时间,未读消息标题前有一个小圆点。条目间用浅灰细线分隔,悬停背景变浅灰,点击进入详情,底部有「加载更多」按钮。

结构与适用场景

结构描述

由纵向排列的列表项组成,每项通常包含前置图标或头像、标题、说明文字,以及右侧的附加信息或操作。

适用场景

  • 每条内容只有标题加一两行说明、用户主要从上到下逐条浏览时,例如消息、通知、评论
  • 条目数量较多,需要在一屏里紧凑地看到尽量多条时
  • 每条点进去能查看详情,列表本身只需露出关键信息时
  • 在手机等窄屏页面上展示多条记录时

不适用场景

  • 条目同质、字段多、需要逐列比较或排序时,应该用表格
  • 每条内容以封面图、商品图为主、需要视觉浏览时,应该用卡片
  • 只有一条记录、需要展示它的全部字段时,应该用描述列表

常见坏用法

  • 每条有七八个字段却挤在一行里用空格隔开,其实应该做成表格
  • 列表项之间没有分隔线也没有间距,文字连成一片,分不清哪条是哪条
  • 把每个列表项都做成带大阴影的卡片,浪费空间,一屏只能看两三条

识别特征

  • 从上到下排列的多行条目,宽度一致
  • 每行左侧常有图标或头像,右侧有时间或箭头
  • 条目之间有细分隔线或统一的间距

DOM 线索

插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。

  • ul:not(nav ul, header ul, footer ul, article ul, li ul, [role]):has(> li + li + li)
  • [role="list"]
  • .list-group
  • .ant-list
  • [class*="MuiList-root"]:not([role="menu"])
  • .arco-list
  • .t-list
  • .n-list