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

    数据展示@rockshin/tao-ui

    展示可滚动条目,支持分组和可选的虚拟渲染。

    何时使用

    用于较长的滚动列表。数据通过 items 传入,rowKey 提供稳定标识,itemRender 定义行内容。选择行为由行内控件负责。

    示例

    基础条目

    默认关闭虚拟渲染。设置 height 可创建有界的滚动区域。

    390 × 640
    TSX

    一千条虚拟列表

    virtual 仅渲染可见窗口中的条目,避免一次挂载全部行。

    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

    分组与固定组标题

    group.key 决定分组,group.title 渲染组标题。sticky 将当前组标题保留在此列表的滚动区域中。

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

    滚动到记录或分组

    ref 接收记录 key、分组 key、数字偏移或坐标对象。

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

    横向内容与 RTL

    scrollWidth 允许宽于视口的行横向滚动,切换 direction 可查看 RTL 行为。

    390 × 640
    TSX

    滚动事件与语义样式

    onScroll 提供滚动元素,rowHoverable 控制行悬停高亮。

    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

    属性说明类型默认值
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-