ant-design/components/list/index.en-US.md
MuYu fb0b4f0fc9 docs: show version Number features were added (#17373)
* docs: add api first appearance

* docs: fix auto-complete doc

* docs: replace Version Added with Version

* docs: date picker common method

* docs: date picker common method

* docs: tree

* docs: remove meaningless 3.0.0
2019-07-11 14:14:33 +08:00

3.7 KiB

category type title cols
Components Data Display List 1

Simple List.

When To Use

A list can be used to display content related to a single subject. The content can consist of multiple elements of varying type and size.

API

List

Property Description Type Default Version
bordered Toggles rendering of the border around the list boolean false
footer List footer renderer string|ReactNode -
grid The grid type of list. You can set grid to something like {gutter: 16, column: 4} object -
header List header renderer string|ReactNode -
itemLayout The layout of list, default is horizontal, If a vertical list is desired, set the itemLayout property to vertical string -
rowKey Item's unique key, could be a string or function that returns a string string|Function(record):string key 3.12.0
loading Shows a loading indicator while the contents of the list are being fetched boolean|object (more) false
loadMore Shows a load more content string|ReactNode -
locale i18n text including empty text object emptyText: 'No Data'
3.4.2
pagination Pagination config, hide it by setting it to false boolean | object false
split Toggles rendering of the split under the list item boolean true
dataSource dataSource array for list any[] - 3.20.1
renderItem customize list item when using dataSource item => ReactNode - 3.20.1

pagination

Properties for pagination.

Property Description Type Default
position specify the position of Pagination 'top' | 'bottom' | 'both' 'bottom'

More about pagination, please check Pagination.

List grid props

Property Description Type Default Version
column column of grid, optional number number -
gutter spacing between grid number 0
size Size of list default | middle | small default
xs <576px column of grid number -
sm ≥576px column of grid number -
md ≥768px column of grid number -
lg ≥992px column of grid number -
xl ≥1200px column of grid number -
xxl ≥1600px column of grid number -

List.Item

Property Description Type Default Version
actions The actions content of list item. If itemLayout is vertical, shows the content on bottom, otherwise shows content on the far right. Array -
extra The extra content of list item. If itemLayout is vertical, shows the content on right, otherwise shows content on the far right. string|ReactNode -

List.Item.Meta

Property Description Type Default Version
avatar The avatar of list item ReactNode -
description The description of list item string|ReactNode -
title The title of list item string|ReactNode -