ant-design/components/list/index.zh-CN.md

category	type	title	subtitle	cols
Components	数据展示	List	列表	1

通用列表。

何时使用

最基础的列表展示，可承载文字、列表、图片、段落，常用于后台数据展示页面。

API

List

参数	说明	类型	默认值	版本
bordered	是否展示边框	boolean	false
footer	列表底部	string|ReactNode	-
grid	列表栅格配置	object	-
header	列表头部	string|ReactNode	-
itemLayout	设置 List.Item 布局, 设置成 vertical 则竖直样式显示, 默认横排	string	-
loading	当卡片内容还在加载中时，可以用 loading 展示一个占位	boolean|object (更多)	false
loadMore	加载更多	string|ReactNode	-
locale	默认文案设置，目前包括空数据文案	object	emptyText: '暂无数据'	3.4.2
pagination	对应的 pagination 配置, 设置 false 不显示	boolean|object	false
size	list 的尺寸	default | middle | small	default
split	是否展示分割线	boolean	true
dataSource	列表数据源	any[]	-	3.20.1
renderItem	当使用 dataSource 时，可以用 renderItem 自定义渲染列表项	item => ReactNode	-	3.20.1

pagination

分页的配置项。

参数	说明	类型	默认值
position	指定分页显示的位置	'top' | 'bottom' | 'both'	'bottom'

更多配置项，请查看 Pagination。

List grid props

参数	说明	类型	默认值	版本
column	列数，可选值	number	-
gutter	栅格间隔	number	0
xs	<576px 展示的列数	number	-
sm	≥576px 展示的列数	number	-
md	≥768px 展示的列数	number	-
lg	≥992px 展示的列数	number	-
xl	≥1200px 展示的列数	number	-
xxl	≥1600px 展示的列数	number	-

List.Item

参数	说明	类型	默认值	版本
actions	列表操作组，根据 itemLayout 的不同, 位置在卡片底部或者最右侧	Array<ReactNode>	-
extra	额外内容, 通常用在 itemLayout 为 vertical 的情况下, 展示右侧内容; horizontal 展示在列表元素最右侧	string|ReactNode	-

List.Item.Meta

参数	说明	类型	默认值	版本
avatar	列表元素的图标	ReactNode	-
description	列表元素的描述内容	string|ReactNode	-
title	列表元素的标题	string|ReactNode	-