For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/components/listy.md.
v0.0.57
  • English
  • Listy

    Data Display@rockshin/tao-ui

    Renders scrollable item collections with grouping and optional virtualization.

    When to use

    Use for long scrollable collections. The data prop is items, each item needs a stable rowKey, and itemRender defines the row. Selection belongs to your row controls.

    Examples

    Basic items

    Virtualization is off by default. Set height to create a bounded scrolling region.

    390 × 640
    TSX

    One thousand virtual rows

    virtual renders the visible window instead of mounting every row at once.

    Activity 1 · row 1
    Activity 2 · row 2
    Activity 3 · row 3
    Activity 4 · row 4
    Activity 5 · row 5
    Activity 6 · row 6
    Activity 7 · row 7
    Activity 8 · row 8
    TSX

    Grouped rows and sticky headings

    group.key chooses a group; group.title renders its header. sticky keeps the current heading visible inside this list.

    Design (20)
    Record 1
    Record 2
    Record 3
    Record 4
    Record 5
    Record 6
    Record 7
    TSX

    Scroll to a record or group

    The ref accepts an item key, group key, numeric offset or a coordinate object.

    Design
    Record 1
    Record 2
    Record 3
    Record 4
    Record 5
    Record 6
    TSX

    Wide content and RTL

    scrollWidth enables horizontal scrolling for rows wider than the viewport. Toggle direction to inspect RTL behavior.

    390 × 640
    TSX

    Scroll events and semantic styles

    onScroll exposes the scrolling element. rowHoverable controls row highlighting.

    Scroll offset: 0 px
    Record 1
    Record 2
    Record 3
    Record 4
    Record 5
    Record 6
    Record 7
    Record 8
    Record 9
    Record 10
    Record 11
    Record 12
    Record 13
    Record 14
    Record 15
    Record 16
    Record 17
    Record 18
    Record 19
    Record 20
    Record 21
    Record 22
    Record 23
    Record 24
    Record 25
    Record 26
    Record 27
    Record 28
    Record 29
    Record 30
    Record 31
    Record 32
    Record 33
    Record 34
    Record 35
    Record 36
    Record 37
    Record 38
    Record 39
    Record 40
    Record 41
    Record 42
    Record 43
    Record 44
    Record 45
    Record 46
    Record 47
    Record 48
    Record 49
    Record 50
    Record 51
    Record 52
    Record 53
    Record 54
    Record 55
    Record 56
    Record 57
    Record 58
    Record 59
    Record 60
    TSX

    API

    Listy

    PropertyDescriptionTypeDefault Value
    classNameAdditional css classstring | undefined-
    styleAdditional styleCSSProperties | undefined-