2017-08-09 15:45:08 +08:00
|
|
|
---
|
|
|
|
|
category: Components
|
2018-11-04 16:20:35 +08:00
|
|
|
type: 数据展示
|
2018-05-21 21:52:18 +08:00
|
|
|
title: List
|
2017-08-09 15:45:08 +08:00
|
|
|
subtitle: 列表
|
|
|
|
|
cols: 1
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
通用列表。
|
|
|
|
|
|
|
|
|
|
## 何时使用
|
|
|
|
|
|
|
|
|
|
最基础的列表展示，可承载文字、列表、图片、段落，常用于后台数据展示页面。
|
|
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
### List
|
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| bordered | 是否展示边框 | boolean | false | |
|
|
|
|
|
| footer | 列表底部 | string\|ReactNode | - | |
|
2020-03-04 21:22:39 +08:00
|
|
|
| grid | 列表栅格配置 | [object](#List-grid-props) | - | |
|
2019-07-11 14:14:33 +08:00
|
|
|
| header | 列表头部 | string\|ReactNode | - | |
|
|
|
|
|
| itemLayout | 设置 `List.Item` 布局, 设置成 `vertical` 则竖直样式显示, 默认横排 | string | - | |
|
2020-04-17 17:56:42 +08:00
|
|
|
| loading | 当卡片内容还在加载中时，可以用 `loading` 展示一个占位 | boolean\|[object](/components/spin/#API) ([更多](https://github.com/ant-design/ant-design/issues/8659)) | false | |
|
2019-07-11 14:14:33 +08:00
|
|
|
| loadMore | 加载更多 | string\|ReactNode | - | |
|
2019-11-20 20:31:43 +08:00
|
|
|
| locale | 默认文案设置，目前包括空数据文案 | object | emptyText: '暂无数据' | |
|
2019-07-11 14:14:33 +08:00
|
|
|
| pagination | 对应的 `pagination` 配置, 设置 `false` 不显示 | boolean\|object | false | |
|
2020-01-17 18:23:58 +08:00
|
|
|
| size | list 的尺寸 | `default` \| `large` \| `small` | `default` | |
|
2019-07-11 14:14:33 +08:00
|
|
|
| split | 是否展示分割线 | boolean | true | |
|
2019-11-20 20:31:43 +08:00
|
|
|
| dataSource | 列表数据源 | any[] | - | |
|
|
|
|
|
| renderItem | 当使用 dataSource 时，可以用 `renderItem` 自定义渲染列表项 | `item => ReactNode` | - | |
|
2017-08-21 21:14:20 +08:00
|
|
|
|
2018-05-21 21:52:18 +08:00
|
|
|
### pagination
|
|
|
|
|
|
|
|
|
|
分页的配置项。
|
|
|
|
|
|
2019-05-07 14:57:32 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 |
|
|
|
|
|
| -------- | ------------------ | --------------------------- | -------- |
|
2020-01-17 17:23:48 +08:00
|
|
|
| position | 指定分页显示的位置 | `top` \| `bottom` \| `both` | `bottom` |
|
2018-05-21 21:52:18 +08:00
|
|
|
|
|
|
|
|
更多配置项，请查看 [`Pagination`](/components/pagination/)。
|
|
|
|
|
|
2017-08-21 21:14:20 +08:00
|
|
|
### List grid props
|
2017-10-25 10:27:38 +08:00
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| column | 列数，[可选值](https://github.com/ant-design/ant-design/blob/a7f17b4cdebbca07b3b9ce5698de61e772d46237/components/list/index.tsx#L16) | number | - | |
|
|
|
|
|
| gutter | 栅格间隔 | number | 0 | |
|
|
|
|
|
| xs | `<576px` 展示的列数 | number | - | |
|
|
|
|
|
| sm | `≥576px` 展示的列数 | number | - | |
|
|
|
|
|
| md | `≥768px` 展示的列数 | number | - | |
|
|
|
|
|
| lg | `≥992px` 展示的列数 | number | - | |
|
|
|
|
|
| xl | `≥1200px` 展示的列数 | number | - | |
|
|
|
|
|
| xxl | `≥1600px` 展示的列数 | number | - | |
|
2017-08-09 15:45:08 +08:00
|
|
|
|
|
|
|
|
### List.Item
|
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| actions | 列表操作组，根据 `itemLayout` 的不同, 位置在卡片底部或者最右侧 | Array<ReactNode> | - | |
|
|
|
|
|
| extra | 额外内容, 通常用在 `itemLayout` 为 `vertical` 的情况下, 展示右侧内容; `horizontal` 展示在列表元素最右侧 | string\|ReactNode | - | |
|
2017-08-09 15:45:08 +08:00
|
|
|
|
|
|
|
|
### List.Item.Meta
|
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| ----------- | ------------------ | ----------------- | ------ | ---- |
|
|
|
|
|
| avatar | 列表元素的图标 | ReactNode | - | |
|
|
|
|
|
| description | 列表元素的描述内容 | string\|ReactNode | - | |
|
|
|
|
|
| title | 列表元素的标题 | string\|ReactNode | - | |
|
