--- category: Components subtitle: 描述列表 group: 数据展示 title: Descriptions cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*fHdlTpif6XQAAAAAAAAAAAAADrJ8AQ/original coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*d27AQJrowGAAAAAAAAAAAAAADrJ8AQ/original --- 成组展示多个只读字段。 ## 何时使用 常见于详情页的信息展示。 ```tsx | pure // >= 5.8.0 可用,推荐的写法 ✅ const items: DescriptionsProps['items'] = [ { key: '1', label: 'UserName', children:

Zhou Maomao

, }, { key: '2', label: 'Telephone', children:

1810000000

, }, { key: '3', label: 'Live', children:

Hangzhou, Zhejiang

, }, { key: '4', label: 'Remark', children:

empty

, }, { key: '5', label: 'Address', children:

No. 18, Wantang Road, Xihu District, Hangzhou, Zhejiang, China

, }, ]; ; // <5.8.0 可用,>=5.8.0 时不推荐 🙅🏻‍♀️ Zhou Maomao 1810000000 Hangzhou, Zhejiang empty No. 18, Wantang Road, Xihu District, Hangzhou, Zhejiang, China ; ``` ## 代码演示 基本 带边框的 复杂文本的情况 自定义尺寸 响应式 垂直 垂直带边框的 自定义 label & wrapper 样式 JSX demo 组件 Token ## API 通用属性参考:[通用属性](/docs/react/common-props) ### Descriptions | 参数 | 说明 | 类型 | 默认值 | 版本 | | --- | --- | --- | --- | --- | | bordered | 是否展示边框 | boolean | false | | | colon | 配置 `Descriptions.Item` 的 `colon` 的默认值 | boolean | true | | | column | 一行的 `DescriptionItems` 数量,可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number \| [Record](https://github.com/ant-design/ant-design/blob/84ca0d23ae52e4f0940f20b0e22eabe743f90dca/components/descriptions/index.tsx#L111C21-L111C56) | 3 | | | contentStyle | 自定义内容样式 | CSSProperties | - | 4.10.0 | | extra | 描述列表的操作区域,显示在右上方 | ReactNode | - | 4.5.0 | | items | 描述列表项内容 | [DescriptionsItem](#descriptionitem)[] | - | 5.8.0 | | labelStyle | 自定义标签样式 | CSSProperties | - | 4.10.0 | | layout | 描述布局 | `horizontal` \| `vertical` | `horizontal` | | | size | 设置列表的大小。可以设置为 `middle` 、`small`, 或不填(只有设置 `bordered={true}` 生效) | `default` \| `middle` \| `small` | - | | | title | 描述列表的标题,显示在最顶部 | ReactNode | - | | ### DescriptionItem | 参数 | 说明 | 类型 | 默认值 | 版本 | | ------------ | -------------- | ------------- | ------ | ----- | | contentStyle | 自定义内容样式 | CSSProperties | - | 4.9.0 | | label | 内容的描述 | ReactNode | - | | | labelStyle | 自定义标签样式 | CSSProperties | - | 4.9.0 | | span | 包含列的数量 | number | 1 | | > span 是 Description.Item 的数量。 span={2} 会占用两个 DescriptionItem 的宽度。当同时配置 `style` 和 `labelStyle`(或 `contentStyle`)时,两者会同时作用。样式冲突时,后者会覆盖前者。 ## 主题变量(Design Token)