跳到主要内容
前端术语库

描述列表

Description List

布局模式也叫:详情描述、键值对列表、属性列表、Descriptions

一句话:把一条记录的多个属性按「字段名:值」成对排列,常用两到三列网格展示,适合只读查看详情。

详细解释

描述列表用来展示一条记录的全部属性,每一项由「标签」和「值」组成,比如「订单号:20260901」「下单时间:2026-09-01」。

它通常按两列或三列排成网格,标签颜色浅、值颜色深,用户可以快速扫读。字段很多时可以分组,每组加一个小标题,比如「基本信息」「收货信息」「支付信息」。

和表单的区别在于它是只读的:值直接显示成文字,而不是输入框。需要修改时,一般放一个「编辑」按钮,点击后再切换成表单。和数据表的区别在于它只展示一条记录:数据表是一行一条、竖着比较多条记录,描述列表是把一条记录的字段摊开来看。

示例

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

怎么跟 AI 说

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

这里是只读的详情展示,请用描述列表(Description List)布局:每个字段显示为「标签:值」,两到三列网格排列,标签用浅灰色,值用正文色,字段按业务含义分组并加分组标题。不要用输入框展示只读数据,右上角放一个「编辑」按钮。

结构与适用场景

结构描述

由若干「标签-值」对组成,按两到三列网格排列;字段多时分为几组,每组带小标题。

适用场景

  • 展示单条记录的详情,字段较多且以只读查看为主时
  • 用户需要快速扫读一条记录的各项属性时
  • 字段之间可以按业务含义分组时

不适用场景

  • 用户需要编辑、填写这些字段时(应该用单页表单)
  • 需要同时展示和比较多条同类记录时(应该用数据表)
  • 字段只有两三个、放进一行文字就能说清时

常见坏用法

  • 把只读详情做成单列表单,每个字段都显示成禁用的输入框
  • 几十个字段不分组,全部平铺成一长串
  • 标签和值字号颜色完全一样,看不出哪个是字段名

识别特征

  • 成对出现的「浅色标签 + 深色值」
  • 两到三列整齐的网格,没有输入框边框
  • 分组小标题把字段分成几块

DOM 线索

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

  • .ant-descriptions
  • .el-descriptions
  • .arco-descriptions
  • .t-descriptions
  • .n-descriptions
  • dl