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/table.md.
v0.0.57
  • 简体中文
  • Table

    数据展示@rockshin/tao-ui

    展示结构化数据,并支持排序、筛选、选择、分页与响应式列。

    何时使用

    用户需要扫描、比较或操作多行结构化数据时使用 Table。

    推荐

    • 列标题简短且与数据一致。
    • 数字列使用一致对齐。
    • 为加载和空数据提供明确状态。

    避免

    • 简单键值信息不需要使用 Table。

    代码演示

    基础用法

    Name
    Role
    Ada LovelaceEngineer
    Grace HopperScientist
    TSX

    变体

    Name
    Role
    AdaEngineer
    GraceScientist
    Name
    Role
    AdaEngineer
    GraceScientist
    Name
    Role
    AdaEngineer
    GraceScientist
    Name
    Role
    AdaEngineer
    GraceScientist
    TSX

    尺寸与边框

    Name
    Status
    BuildPassing
    Name
    Status
    BuildPassing
    Name
    Status
    BuildPassing
    TSX

    加载、空状态与分页

    Name
    No Data
    Name
    No matching users.
    Name
    User 1
    User 2
    User 3
    User 4
    User 5
    TSX

    固定表头、展开行与总结栏

    scroll.y 限制表体高度并让表头吸顶;expandable 在行下方展开详情(展开列位于选择列之前);summary 返回 Table.Summary.Row / Table.Summary.Cell 作为总结栏,Cell 的 index 从展开列/选择列开始计数,用于同步固定列,`` 在纵向滚动时吸底。

    Name
    Team
    Score
    User 1Design60
    User 2Engineering67
    User 3Sales74
    User 4Design81
    User 5Engineering88
    User 6Sales95
    User 7Design62
    User 8Engineering69
    User 9Sales76
    User 10Design83
    User 11Engineering90
    User 12Sales97
    User 13Design64
    User 14Engineering71
    User 15Sales78
    User 16Design85
    User 17Engineering92
    User 18Sales99
    User 19Design66
    User 20Engineering73
    User 21Sales80
    User 22Design87
    User 23Engineering94
    User 24Sales61
    User 25Design68
    User 26Engineering75
    User 27Sales82
    User 28Design89
    User 29Engineering96
    User 30Sales63
    Total2365
    TSX

    排序

    使用列的排序配置;点击表头在排序方向之间切换。

    Role
    Alice22admin
    Eve22viewer
    Alice22editor
    Bob23editor
    Frank23admin
    Bob23viewer
    Charlie24viewer
    Grace24editor
    Charlie24admin
    Diana25admin
    TSX

    列筛选

    为列提供筛选项与筛选函数,在菜单中选择后观察数据变化。

    Name
    Age
    Role
    Department
    Alice22adminEngineering
    Bob23editorDesign
    Charlie24viewerMarketing
    Diana25adminSales
    Eve26editorEngineering
    Frank27viewerDesign
    Grace28adminMarketing
    Hank29editorSales
    Alice30viewerEngineering
    Bob31adminDesign
    TSX

    受控行选择

    用数据库 ID 等稳定标识作为 rowKey。将选中的行键存入 rowSelection.selectedRowKeys,再通过 rowSelection.onChange 更新。

    在 rowSelection.getCheckboxProps(record) 返回 { disabled: true } 可禁止选择该行。表头复选框只处理当前页可选行,保留其他页的选择。从 0.0.49 起,组件还会在行状态变化而回调引用保持不变时,按最新的禁用状态全选。

    Selected: none

    ID
    Name
    Age
    Email
    Role
    1Alice22user1@example.comadmin
    2Bob23user2@example.comeditor
    3Charlie24user3@example.comviewer
    4Diana25user4@example.comadmin
    5Eve26user5@example.comeditor
    6Frank27user6@example.comviewer
    7Grace28user7@example.comadmin
    8Hank29user8@example.comeditor
    9Alice30user9@example.comviewer
    10Bob31user10@example.comadmin
    TSX

    横向滚动与固定列

    用列宽和 scroll.x 约束宽表格,固定列在滚动时保留上下文。

    ID
    Name
    Age
    Email
    Role
    Department
    Actions
    1Alice22user1@example.comadminEngineering
    2Bob23user2@example.comeditorDesign
    3Charlie24user3@example.comviewerMarketing
    4Diana25user4@example.comadminSales
    5Eve26user5@example.comeditorEngineering
    6Frank27user6@example.comviewerDesign
    7Grace28user7@example.comadminMarketing
    8Hank29user8@example.comeditorSales
    TSX

    固定表头

    scroll.y 将数据区变为有界滚动容器,表头保持可见。

    ID
    Name
    Age
    Email
    Role
    Department
    1Alice22user1@example.comadminEngineering
    2Bob23user2@example.comeditorDesign
    3Charlie24user3@example.comviewerMarketing
    4Diana25user4@example.comadminSales
    5Eve26user5@example.comeditorEngineering
    6Frank27user6@example.comviewerDesign
    7Grace28user7@example.comadminMarketing
    8Hank29user8@example.comeditorSales
    9Alice30user9@example.comviewerEngineering
    10Bob31user10@example.comadminDesign
    11Charlie32user11@example.comeditorMarketing
    12Diana33user12@example.comviewerSales
    13Eve34user13@example.comadminEngineering
    14Frank35user14@example.comeditorDesign
    15Grace36user15@example.comviewerMarketing
    16Hank37user16@example.comadminSales
    17Alice38user17@example.comeditorEngineering
    18Bob39user18@example.comviewerDesign
    19Charlie40user19@example.comadminMarketing
    20Diana41user20@example.comeditorSales
    21Eve22user21@example.comviewerEngineering
    22Frank23user22@example.comadminDesign
    23Grace24user23@example.comeditorMarketing
    24Hank25user24@example.comviewerSales
    25Alice26user25@example.comadminEngineering
    26Bob27user26@example.comeditorDesign
    27Charlie28user27@example.comviewerMarketing
    28Diana29user28@example.comadminSales
    29Eve30user29@example.comeditorEngineering
    30Frank31user30@example.comviewerDesign
    31Grace32user31@example.comadminMarketing
    32Hank33user32@example.comeditorSales
    33Alice34user33@example.comviewerEngineering
    34Bob35user34@example.comadminDesign
    35Charlie36user35@example.comeditorMarketing
    36Diana37user36@example.comviewerSales
    37Eve38user37@example.comadminEngineering
    38Frank39user38@example.comeditorDesign
    39Grace40user39@example.comviewerMarketing
    40Hank41user40@example.comadminSales
    41Alice22user41@example.comeditorEngineering
    42Bob23user42@example.comviewerDesign
    43Charlie24user43@example.comadminMarketing
    44Diana25user44@example.comeditorSales
    45Eve26user45@example.comviewerEngineering
    46Frank27user46@example.comadminDesign
    ID
    Name
    Age
    Email
    Role
    Department
    1Alice22user1@example.comadminEngineering
    2Bob23user2@example.comeditorDesign
    3Charlie24user3@example.comviewerMarketing
    4Diana25user4@example.comadminSales
    5Eve26user5@example.comeditorEngineering
    6Frank27user6@example.comviewerDesign
    7Grace28user7@example.comadminMarketing
    8Hank29user8@example.comeditorSales
    9Alice30user9@example.comviewerEngineering
    10Bob31user10@example.comadminDesign
    11Charlie32user11@example.comeditorMarketing
    12Diana33user12@example.comviewerSales
    13Eve34user13@example.comadminEngineering
    14Frank35user14@example.comeditorDesign
    15Grace36user15@example.comviewerMarketing
    16Hank37user16@example.comadminSales
    17Alice38user17@example.comeditorEngineering
    18Bob39user18@example.comviewerDesign
    19Charlie40user19@example.comadminMarketing
    20Diana41user20@example.comeditorSales
    21Eve22user21@example.comviewerEngineering
    22Frank23user22@example.comadminDesign
    23Grace24user23@example.comeditorMarketing
    24Hank25user24@example.comviewerSales
    25Alice26user25@example.comadminEngineering
    26Bob27user26@example.comeditorDesign
    27Charlie28user27@example.comviewerMarketing
    28Diana29user28@example.comadminSales
    29Eve30user29@example.comeditorEngineering
    30Frank31user30@example.comviewerDesign
    31Grace32user31@example.comadminMarketing
    32Hank33user32@example.comeditorSales
    33Alice34user33@example.comviewerEngineering
    34Bob35user34@example.comadminDesign
    35Charlie36user35@example.comeditorMarketing
    36Diana37user36@example.comviewerSales
    37Eve38user37@example.comadminEngineering
    38Frank39user38@example.comeditorDesign
    39Grace40user39@example.comviewerMarketing
    40Hank41user40@example.comadminSales
    41Alice22user41@example.comeditorEngineering
    42Bob23user42@example.comviewerDesign
    43Charlie24user43@example.comadminMarketing
    44Diana25user44@example.comeditorSales
    45Eve26user45@example.comviewerEngineering
    46Frank27user46@example.comadminDesign
    ID
    Name
    Age
    Email
    Role
    Department
    1Alice22user1@example.comadminEngineering
    2Bob23user2@example.comeditorDesign
    3Charlie24user3@example.comviewerMarketing
    4Diana25user4@example.comadminSales
    5Eve26user5@example.comeditorEngineering
    6Frank27user6@example.comviewerDesign
    7Grace28user7@example.comadminMarketing
    8Hank29user8@example.comeditorSales
    9Alice30user9@example.comviewerEngineering
    10Bob31user10@example.comadminDesign
    11Charlie32user11@example.comeditorMarketing
    12Diana33user12@example.comviewerSales
    13Eve34user13@example.comadminEngineering
    14Frank35user14@example.comeditorDesign
    15Grace36user15@example.comviewerMarketing
    16Hank37user16@example.comadminSales
    17Alice38user17@example.comeditorEngineering
    18Bob39user18@example.comviewerDesign
    19Charlie40user19@example.comadminMarketing
    20Diana41user20@example.comeditorSales
    21Eve22user21@example.comviewerEngineering
    22Frank23user22@example.comadminDesign
    23Grace24user23@example.comeditorMarketing
    24Hank25user24@example.comviewerSales
    25Alice26user25@example.comadminEngineering
    26Bob27user26@example.comeditorDesign
    27Charlie28user27@example.comviewerMarketing
    28Diana29user28@example.comadminSales
    29Eve30user29@example.comeditorEngineering
    30Frank31user30@example.comviewerDesign
    31Grace32user31@example.comadminMarketing
    32Hank33user32@example.comeditorSales
    33Alice34user33@example.comviewerEngineering
    34Bob35user34@example.comadminDesign
    35Charlie36user35@example.comeditorMarketing
    36Diana37user36@example.comviewerSales
    37Eve38user37@example.comadminEngineering
    38Frank39user38@example.comeditorDesign
    39Grace40user39@example.comviewerMarketing
    40Hank41user40@example.comadminSales
    41Alice22user41@example.comeditorEngineering
    42Bob23user42@example.comviewerDesign
    43Charlie24user43@example.comadminMarketing
    44Diana25user44@example.comeditorSales
    45Eve26user45@example.comviewerEngineering
    46Frank27user46@example.comadminDesign
    TSX

    展开行

    展开记录查看附加详情,不把所有内容塞进表格列。

    ID
    Name
    Age
    Email
    Role
    1Alice22user1@example.comadmin
    Alice works in Engineering as admin.
    2Bob23user2@example.comeditor
    3Charlie24user3@example.comviewer
    4Diana25user4@example.comadmin
    5Eve26user5@example.comeditor
    6Frank27user6@example.comviewer
    TSX

    展开行与滚动组合

    同时使用展开内容和固定高度,检查展开后滚动与列对齐。

    Name
    Email
    Department
    Role
    Aliceuser1@example.comEngineeringadmin
    Bobuser2@example.comDesigneditor
    Bob works in Design as editor; this text stays inside the visible area while the table scrolls sideways.
    Charlieuser3@example.comMarketingviewer
    Dianauser4@example.comSalesadmin
    Eveuser5@example.comEngineeringeditor
    TSX

    总结栏

    通过 Table.Summary 渲染统计结果,并与表格列对齐。

    Name
    Department
    Email
    Age
    AliceEngineeringuser1@example.com22
    BobDesignuser2@example.com23
    CharlieMarketinguser3@example.com24
    DianaSalesuser4@example.com25
    EveEngineeringuser5@example.com26
    FrankDesignuser6@example.com27
    GraceMarketinguser7@example.com28
    HankSalesuser8@example.com29
    AliceEngineeringuser9@example.com30
    BobDesignuser10@example.com31
    CharlieMarketinguser11@example.com32
    DianaSalesuser12@example.com33
    EveEngineeringuser13@example.com34
    FrankDesignuser14@example.com35
    GraceMarketinguser15@example.com36
    HankSalesuser16@example.com37
    AliceEngineeringuser17@example.com38
    BobDesignuser18@example.com39
    CharlieMarketinguser19@example.com40
    DianaSalesuser20@example.com41
    Total20 people630
    TSX

    自定义分页

    由调用方维护分页状态,适合与接口返回的总量和页数据配合。

    ID
    Name
    Age
    Email
    Role
    1Alice22user1@example.comadmin
    2Bob23user2@example.comeditor
    3Charlie24user3@example.comviewer
    4Diana25user4@example.comadmin
    5Eve26user5@example.comeditor
    TSX

    组合使用

    组合排序、筛选和选择,观察这些状态如何共同影响当前数据。

    ID
    Email
    Role
    Dept
    Actions
    1Alice22user1@example.comadminEngineering
    2Bob23user2@example.comeditorDesign
    3Charlie24user3@example.comviewerMarketing
    4Diana25user4@example.comadminSales
    5Eve26user5@example.comeditorEngineering
    6Frank27user6@example.comviewerDesign
    7Grace28user7@example.comadminMarketing
    8Hank29user8@example.comeditorSales
    9Alice30user9@example.comviewerEngineering
    10Bob31user10@example.comadminDesign
    TSX

    响应式列

    通过列的响应式配置调整小屏展示,核心识别字段始终保留。

    390 × 640
    TSX

    API

    Table

    属性说明类型默认值
    scrolly caps the body height and keeps the header pinned while it scrolls.{ x?: string | number | undefined; y?: string | number | undefined; } | undefined-
    summaryFooter rows built from Table.Summary.Row / Table.Summary.Cell.((pageData: T[]) => ReactNode) | undefined-
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-

    Table.Summary

    属性说明类型默认值
    fixedPin the summary to the bottom while the body scrolls (needs scroll.y).boolean | undefined-