ant-design/components/list/index.en-US.md
Gabriel Nunes a513ee1d73 Add docs for the List rowKey prop
Add documentation for the rowKey property of the lists
2018-12-28 10:34:44 +08:00

3.2 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
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
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'
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

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
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
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
avatar The avatar of list item ReactNode -
description The description of list item string|ReactNode -
title The title of list item string|ReactNode -