ant-design/components/list/index.zh-CN.md
2018-06-24 17:09:18 +08:00

2.5 KiB

category type title subtitle cols
Components Data Display 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: '暂无数据'
pagination 对应的 pagination 配置, 设置 false 不显示 boolean|object false
size list 的尺寸 default | middle | small default
split 是否展示分割线 boolean true

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 额外内容, 通常用在 itemLayoutvertical 的情况下, 展示右侧内容; horizontal 展示在列表元素最右侧 string|ReactNode -

List.Item.Meta

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