Descriptions 描述列表
以表格化列表展示成组的只读字段，常用于详情页、审计信息等只读场景。字段由 eb-descriptions-item 声明（结构性子件，由父级收集渲染），支持边框模式、数字与响应式断点列数、标签冒号、水平 / 垂直排列、跨列与单元格对齐、单元格样式与列宽控制。
基础用法
title 显示在左上角，extra（属性或插槽）放在标题右侧，常用于放置操作按钮；column 控制每行列数，border 切换带边框模式。
| 客户 | 张三 | 手机号 | 13800000000 |
|---|---|---|---|
| 支付方式 | 微信支付 | 状态 | 已支付 |
垂直排列
direction="vertical" 时标签在上、内容在下（渲染为两个 tbody），适合字段值较长的场景。
| 屏幕 | 电池 | 重量 |
|---|---|---|
| 6.7 英寸 OLED | 5000mAh | 198g |
跨列
span 指定字段占用的列数，超出当前行剩余列时自动收敛；末行不满列时由最后一格补满（与主流组件库相同的填充语义）。
| 售后类型 | 退货退款 | 联系人 | 李四 13800000000 | ||
|---|---|---|---|---|---|
| 原因 | 商品与描述不符，外包装破损。 | ||||
尺寸
size 支持三档，控制标签与内容的内边距密度，可与 column、border 自由组合。
| 规格 | 500g | 产地 | 云南 |
|---|---|---|---|
| 保质期 | 12 个月 | 储存条件 | 阴凉干燥处 |
对齐与列宽
align 控制内容对齐、label-align 单独控制标签对齐；width 固定内容列宽、min-width 约束标签列最小宽，用于表单化详情的纵向对齐。
| 订单号 | SO-20260801-001 | 金额 | ¥ 12,800.00 |
|---|---|---|---|
| 备注 | 全程冷链配送 | ||
插槽自定义
title、extra 插槽分别替换标题与右上区域；eb-descriptions-item 的 #label 插槽自定义标签（如追加说明），默认插槽放内容。
| 手机号（已验证） | 138****0000 | 邮箱 | wil@example.com |
|---|
标签冒号与单元格样式
colon 开启后在每个标签后渲染冒号（次要文本色；antd 默认 true，本组件默认 false 保持既有视觉）；label-style / content-style 为容器级单元格样式，item 级同名属性可逐项覆盖，与 width / min-width 自由叠加。
| 渠道: | Web 控制台 | 环境: | 生产 |
|---|---|---|---|
| 负责人: | 运营组 | 值班: | 7 x 24 |
响应式列数
column 除数字外支持 { xs, sm, md, lg } 对象形态（min-width 断点 0 / 576 / 768 / 992，由小到大命中）：窄屏自动降为单列阅读，宽屏恢复多列，服务端渲染按最小档输出。
| 订单号 | SO-20260920-001 |
|---|---|
| 金额 | ¥ 399.00 |
| 支付方式 | 支付宝 |
| 状态 | 已发货 |
API
Descriptions Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| title | 标题文本 | string | |
| extra | 标题右侧附加文本 | string | |
| column | 每行列数（数字向下取整最小 1）；或响应式对象 { xs, sm, md, lg }，由小到大命中断点，全不命中回退最小已声明档 | number | { xs, sm, md, lg } | 3 |
| colon | 标签后显示冒号（antd 默认 true，本组件默认 false 保持既有视觉） | boolean | false |
| labelStyle | 容器级标签单元格样式，item 同名属性可覆盖 | object | — |
| contentStyle | 容器级内容单元格样式，item 同名属性可覆盖 | object | — |
| border | 边框模式 | boolean | false |
| direction | 排列方向：horizontal 标签左内容右，vertical 标签上内容下 | horizontal | vertical | horizontal |
| size | 尺寸 | large | default | small | default |
Descriptions Slots
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| default | eb-descriptions-item 列表 | — | — |
| title | 自定义标题 | — | — |
| extra | 自定义标题右侧区域 | — | — |
DescriptionsItem Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| label | 标签文本（优先级低于 label 插槽） | string | |
| span | 占用列数，超出当前行剩余列时自动收敛 | number | 1 |
| width | 内容列固定宽度（按 px 渲染） | string | number | |
| minWidth | 标签列最小宽度（按 px 渲染） | string | number | |
| align | 内容对齐 | left | center | right | left |
| labelAlign | 标签对齐，缺省跟随 align | left | center | right | |
| className | 内容单元格类名（也接受 class-name 形式） | string | |
| labelClassName | 标签单元格类名（也接受 label-class-name 形式） | string | |
| labelStyle | 标签单元格样式对象，覆盖容器级 label-style | object | — |
| contentStyle | 内容单元格样式对象，覆盖容器级 content-style | object | — |
DescriptionsItem Slots
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| default | 内容文本 | — | — |
| label | 自定义标签 | — | — |