Paginated ListView

The Paginated ListView is a specialized list view that can load its data in pages. This is useful for displaying very large datasets without having to load all the data at once.

Properties

Property
Description

dataSource

A static list of data to display.

apiDataSource

An API endpoint to fetch the data from.

allowScroll

If true, the list will be scrollable.

shrinkWrap

If true, the extent of the scroll view is determined by the size of the children.

scrollDirection

The direction in which the list scrolls (vertical or horizontal).

reverse

If true, the list scrolls in the opposite direction.

initialScrollPosition

The initial position of the scroll view (start or end).

transformItems

An expression to transform the data before it is displayed.

firstPageKey

An expression to get the key for the first page of data.

nextPageKey

An expression to get the key for the next page of data.

Children of Paginated ListView

Slot
Description

children

The widget to use as a template for each item in the list.

firstPageLoadingIndicator

A widget to display while the first page of data is loading.

newPageLoadingIndicator

A widget to display while subsequent pages of data are loading.


Default Properties

The Paginated ListView widget supports all three sections of default properties:

Layout

  • width

  • height

  • padding

  • margin

  • align

Appearance

  • bgColor

  • borderRadius

  • border

    • borderWidth

    • borderColor

    • borderType (e.g., solid, dashed)

    • strokeAlign

Interactions

  • onClick — Used to add actions to the Paginated ListView widget.

Last updated