2019-05-22 23:22:09 +08:00
|
|
|
---
|
|
|
|
|
category: Components
|
|
|
|
|
subtitle: 描述列表
|
|
|
|
|
type: 数据展示
|
|
|
|
|
title: Descriptions
|
|
|
|
|
cols: 1
|
2020-05-31 11:48:34 +08:00
|
|
|
cover: https://gw.alipayobjects.com/zos/alicdn/MjtG9_FOI/Descriptions.svg
|
2019-05-22 23:22:09 +08:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
成组展示多个只读字段。
|
|
|
|
|
|
|
|
|
|
## 何时使用
|
|
|
|
|
|
|
|
|
|
常见于详情页的信息展示。
|
|
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
### Descriptions
|
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
2019-11-20 20:31:43 +08:00
|
|
|
| title | 描述列表的标题，显示在最顶部 | ReactNode | - | |
|
2020-07-14 20:37:21 +08:00
|
|
|
| extra | 描述列表的操作区域，显示在右上方 | string \| ReactNode | - | 4.5.0 |
|
2019-11-20 20:31:43 +08:00
|
|
|
| bordered | 是否展示边框 | boolean | false | |
|
|
|
|
|
| column | 一行的 `DescriptionItems` 数量，可以写成像素值或支持响应式的对象写法 `{ xs: 8, sm: 16, md: 24}` | number | 3 | |
|
2020-07-01 22:37:55 +08:00
|
|
|
| size | 设置列表的大小。可以设置为 `middle` 、`small`, 或不填（只有设置 `bordered={true}` 生效） | `default` \| `middle` \| `small` | - | |
|
2020-01-17 17:23:48 +08:00
|
|
|
| layout | 描述布局 | `horizontal` \| `vertical` | `horizontal` | |
|
2019-11-20 20:31:43 +08:00
|
|
|
| colon | 配置 `Descriptions.Item` 的 `colon` 的默认值 | boolean | true | |
|
2019-05-22 23:22:09 +08:00
|
|
|
|
|
|
|
|
### DescriptionItem
|
|
|
|
|
|
2019-11-20 20:31:43 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| ----- | ------------ | --------- | ------ | ---- |
|
|
|
|
|
| label | 内容的描述 | ReactNode | - | |
|
|
|
|
|
| span | 包含列的数量 | number | 1 | |
|
2019-08-16 10:01:46 +08:00
|
|
|
|
2019-09-16 11:23:26 +08:00
|
|
|
> span 是 Description.Item 的数量。 span={2} 会占用两个 DescriptionItem 的宽度。
|
