描述列表
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-descriptionsdl