Skip to main content

ListView

A scrollable list of controls arranged linearly.

ListView is the most commonly used scrolling control. It displays its children one after another in the scroll direction. In the cross axis, the children are required to fill the ListView.

info

ListView is very effective for large lists (thousands of items). Prefer it over Column or Row for smooth scrolling.

Examples​

Live example

Auto-scrolling ListView​

from time import sleep
import flet as ft

def main(page: ft.Page):
    page.title = "Auto-scrolling ListView"

    lv = ft.ListView(expand=1, spacing=10, padding=20, auto_scroll=True)

    count = 1

    for i in range(0, 60):
        lv.controls.append(ft.Text(f"Line {count}"))
        count += 1

    page.add(lv)

    for i in range(0, 60):
        sleep(1)
        lv.controls.append(ft.Text(f"Line {count}"))
        count += 1
        page.update()

ft.app(target=main)

Properties​

auto_scroll​

True if scrollbar should automatically move its position to the end when children updated. Must be False for scroll_to() method to work.

controls​

A list of Controls to display inside ListView.

divider_thickness​

If greater than 0 then Divider is used as a spacing between ListView items.

first_item_prototype​

True if the dimensions of the first item should be used as a "prototype" for all other items, i.e. their height or width will be the same as the first item. Default is False.

horizontal​

True to layout ListView items horizontally.

item_extent​

A fixed height or width (for horizontal ListView) of an item to optimize rendering.

on_scroll_interval​

Throttling in milliseconds for on_scroll event. Default is 10.

padding​

The amount of space by which to inset the children.

See Container.padding property for more information and possible values.

spacing​

The height of Divider between ListView items. No spacing between items if not specified.

Methods​

scroll_to(offset, delta, key, duration, curve)​

Moves scroll position to either absolute offset, relative delta or jump to the control with specified key.

See Column.scroll_to() for method details and examples.

Events​

on_scroll​

Fires when scroll position is changed by a user.

See Column.on_scroll for event details and examples.