You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ant-design-vue/components/list/index.en-US.md

3.7 KiB

category type title cover coverDark
Components Data Display List https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*EYuhSpw1iSwAAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*tBzwQ7raKX8AAAAAAAAAAAAADrJ8AQ/original

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
dataSource dataSource array for list any[] - 3.20.1
footer List footer renderer string|slot -
grid The grid type of list. You can set grid to something like {gutter: 16, column: 4} object -
header List header renderer string|slot -
itemLayout The layout of list, default is horizontal, If a vertical list is desired, set the itemLayout property to vertical string -
loading Shows a loading indicator while the contents of the list are being fetched boolean|object false
loadMore Shows a load more content string|slot -
locale i18n text including empty text object emptyText: 'No Data'
pagination Pagination config, hide it by setting it to false boolean | object false
renderItem Custom item renderer, #renderItem="{item, index}" ({item, index}) => vNode -
rowKey Item's unique key, could be a string or function that returns a string string|Function(record):string key
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 Version
column column of grid number oneOf [ 1, 2, 3, 4, 6, 8, 12, 24] -
gutter spacing between grid number 0
size Size of list default | middle | small default
xxxl ≥2000px column of grid number - 3.0
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. vNode[] |slot -
extra The extra content of list item. If itemLayout is vertical, shows the content on right, otherwise shows content on the far right. string|slot -

List.Item.Meta

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