mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-29 13:47:02 +08:00
fb0b4f0fc9
* 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
3.7 KiB
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 | - |