---
title:
    en-US: DescriptionList
    zh-CN: DescriptionList
subtitle: 描述列表
cols: 1
order: 4
---

成组展示多个只读字段，常见于详情页的信息展示。

## API

### DescriptionList

| 参数   | 说明                                                                                                        | 类型                           | 默认值       |
| ------ | ----------------------------------------------------------------------------------------------------------- | ------------------------------ | ------------ |
| layout | 布局方式                                                                                                    | Enum{'horizontal', 'vertical'} | 'horizontal' |
| col    | 指定信息最多分几列展示，最终一行几列由 col 配置结合[响应式规则](/components/DescriptionList#响应式规则)决定 | number(0 < col <= 4)           | 3            |
| title  | 列表标题                                                                                                    | ReactNode                      | -            |
| gutter | 列表项间距，单位为 `px`                                                                                     | number                         | 32           |
| size   | 列表型号，可以设置为 `large` `small`                                                                        | Enum{'large', 'small'}         | -            |

#### 响应式规则

| 窗口宽度 | 展示列数            |
| -------- | ------------------- |
| `≥768px` | `col`               |
| `≥576px` | `col < 2 ? col : 2` |
| `<576px` | `1`                 |

### DescriptionList.Description

| 参数 | 说明       | 类型      | 默认值 |
| ---- | ---------- | --------- | ------ |
| term | 列表项标题 | ReactNode | -      |
