---
url: /components/descriptions.md
---
# Descriptions 描述列表

以表格化列表展示成组的只读字段，常用于详情页、审计信息等只读场景。字段由 `eb-descriptions-item` 声明（结构性子件，由父级收集渲染），支持边框模式、数字与响应式断点列数、标签冒号、水平 / 垂直排列、跨列与单元格对齐、单元格样式与列宽控制。

## 基础用法

`title` 显示在左上角，`extra`（属性或插槽）放在标题右侧，常用于放置操作按钮；`column` 控制每行列数，`border` 切换带边框模式。

## 垂直排列

`direction="vertical"` 时标签在上、内容在下（渲染为两个 tbody），适合字段值较长的场景。

## 跨列

`span` 指定字段占用的列数，超出当前行剩余列时自动收敛；末行不满列时由最后一格补满（与主流组件库相同的填充语义）。

## 尺寸

`size` 支持三档，控制标签与内容的内边距密度，可与 `column`、`border` 自由组合。

## 对齐与列宽

`align` 控制内容对齐、`label-align` 单独控制标签对齐；`width` 固定内容列宽、`min-width` 约束标签列最小宽，用于表单化详情的纵向对齐。

## 插槽自定义

`title`、`extra` 插槽分别替换标题与右上区域；`eb-descriptions-item` 的 `#label` 插槽自定义标签（如追加说明），默认插槽放内容。

## 标签冒号与单元格样式

`colon` 开启后在每个标签后渲染冒号（次要文本色；antd 默认 true，本组件默认 false 保持既有视觉）；`label-style` / `content-style` 为容器级单元格样式，item 级同名属性可逐项覆盖，与 `width` / `min-width` 自由叠加。

## 响应式列数

`column` 除数字外支持 `{ xs, sm, md, lg }` 对象形态（min-width 断点 0 / 576 / 768 / 992，由小到大命中）：窄屏自动降为单列阅读，宽屏恢复多列，服务端渲染按最小档输出。

## API