Skip to content

Descriptions 描述列表 ​

成组展示多个只读字段,常用于详情页 / 资料卡。

何时使用 ​

  • 详情页展示订单 / 用户 / 资源的属性。
  • 接口返回的多字段以"标签 + 值"形式呈现。

基本使用 ​

items 描述每条字段;默认 column=3 三列均分。

带边框 ​

bordered 切换为表格风格,每个 cell 都带边框,便于阅读。

控制列数 ​

column 改变列数;某项的 span 可让它跨多列。

不同尺寸 ​

size:small / default / middle,影响 padding 和字号。

纵向布局 ​

layout="vertical" 把"标签 / 值"上下排,常用于较长内容。

隐藏冒号 / 自定义样式 ​

colon=false 隐藏冒号;每项可单独传 labelStyle / contentStyle。

API ​

Descriptions Props ​

参数类型默认值说明
titlestring''顶部标题
extrastring''标题右端附加内容
borderedbooleanfalse表格风格的边框
columnnumber3列数
size'small' | 'default' | 'middle''default'尺寸
layout'horizontal' | 'vertical''horizontal'label / value 排布
colonbooleantrue显示冒号
itemsDescriptionsItem[]—描述项数据

DescriptionsItem ​

字段类型说明
labelstring标签
valuestring | number值
spannumber跨列数(默认 1)
labelStyleCSSProperties单项 label 样式
contentStyleCSSProperties单项内容样式

id、aria-*、data-* 等原生属性会透传到根节点。column 和 span 应使用正整数;无效值会按 1 列处理。

Released under the MIT License.