---
category: Components
type: 数据展示
title: Descriptions
subtitle: 描述列表
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*fHdlTpif6XQAAAAAAAAAAAAADrJ8AQ/original
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*d27AQJrowGAAAAAAAAAAAAAADrJ8AQ/original
---

成组展示多个只读字段。

## 何时使用

常见于详情页的信息展示。

## API

### Descriptions props

| 参数         | 说明                                                                                            | 类型                             | 默认值       | 版本  |     |     |
| ------------ | ----------------------------------------------------------------------------------------------- | -------------------------------- | ------------ | ----- | --- | --- |
| bordered     | 是否展示边框                                                                                    | boolean                          | false        |       |     |     |
| colon        | 配置 `Descriptions.Item` 的 `colon` 的默认值                                                    | boolean                          | true         |       |     |     |
| column       | 一行的 `DescriptionItems` 数量，可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number                           | 3            |       |     |     |
| contentStyle | 自定义内容样式                                                                                  | CSSProperties                    | -            | 2.2.0 |     |     |
| extra        | 描述列表的操作区域，显示在右上方                                                                | string \| VNode \| slot          | -            | 2.0.0 |     |     |
| labelStyle   | 自定义标签样式                                                                                  | CSSProperties                    | -            | 2.2.0 |     |     |
| layout       | 描述布局                                                                                        | `horizontal` \| `vertical`       | `horizontal` |       |     |
| size         | 设置列表的大小。可以设置为 `middle` 、`small`, 或不填（只有设置 `bordered={true}` 生效）        | `default` \| `middle` \| `small` | `default`    |       |
| title        | 描述列表的标题，显示在最顶部                                                                    | string \| VNode \| slot          | -            |       |     |     |

### Item props

| 参数         | 说明           | 类型                    | 默认值 | 版本  |
| ------------ | -------------- | ----------------------- | ------ | ----- |
| contentStyle | 自定义内容样式 | CSSProperties           | -      | 2.2.0 |
| label        | 内容的描述     | string \| VNode \| slot | -      |       |
| labelStyle   | 自定义标签样式 | CSSProperties           | -      | 2.2.0 |
| span         | 包含列的数量   | number                  | 1      |       |

> span 是 Descriptions.Item 的数量。 span={2} 会占用两个 DescriptionsItem 的宽度。
