Angular 数据表格与分页列表 | ng-hub-ui-paginable

Angular 数据表格和分页列表，支持服务端分页、排序、筛选、选择、模板和 CSS 变量。

交互式示例

探索实时示例，了解该库在常见 Angular 用例中的表现。

快速开始

表格基础用法

ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comEditor

显示 4 / 4 行

可分页与可选择列表

  • J
    John Doe
    john@example.com
  • J
    Jane Smith
    jane@example.com
  • B
    Bob Johnson
    bob@example.com
  • A
    Alice Brown
    alice@example.com
  • C
    Charlie Wilson
    charlie@example.com
  • D
    Diana Prince
    diana@example.com
  • E
    Evan Brooks
    evan@example.com
  • F
    Fiona Green
    fiona@example.com

显示 8 / 8 行

Selected: 0 items

分页、排序与筛选

表格分页

ID
Name
Department
Position
Salary
Email
1John DoeEngineeringSenior Developer85000john.doe@company.com
2Jane SmithMarketingMarketing Manager72000jane.smith@company.com
3Bob JohnsonEngineeringFrontend Developer65000bob.johnson@company.com
4Alice BrownHRHR Specialist58000alice.brown@company.com
5Charlie WilsonSalesSales Representative55000charlie.wilson@company.com

显示 5 / 20 行

Total employees: 20 | Current page: 1 | Page size: 5

客户端分页

Name
Department
Position
Salary
John DoeEngineeringSenior Developer85000
Jane SmithMarketingMarketing Manager72000
Bob JohnsonEngineeringFrontend Developer65000
Alice BrownHRHR Specialist58000
Charlie WilsonSalesSales Representative55000

显示 5 / 23 行

The full array (23 rows) is handed to the table — it searches, filters, sorts and paginates entirely in memory. No totalItems, no parent logic.

基础排序与筛选

ID
Name
Role
Status
4Alice BrownEditorActive
3Bob JohnsonUserPending
5Charlie WilsonUserDeleted
2Jane SmithEditorInactive
1John DoeAdminActive

显示 5 / 5 行

高级筛选（菜单与范围）

ID
Product
Price ($)
Added Date
Category
1Laptop1200Sun Oct 01 2023 00:00:00 GMT+0000 (Coordinated Universal Time)Electronics
2Mouse25Wed Nov 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)Electronics
3Keyboard75Mon Nov 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)Electronics
4Desk Lamp45Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)Office
5Chair250Sun Dec 10 2023 00:00:00 GMT+0000 (Coordinated Universal Time)Office

显示 5 / 5 行

自定义过滤器模板

Order ID
Customer
Product
Amount
Status
Priority
1001John DoeLaptop1299PendingHigh
1002Jane SmithMouse29ShippedLow
1003Bob JohnsonMonitor549DeliveredMedium
1004Alice BrownKeyboard89PendingMedium
1005Charlie WilsonChair399CancelledLow
1006Diana MartinezDesk799ShippedHigh
1007Edward TaylorWebcam149DeliveredLow
1008Fiona AndersonHeadphones199PendingMedium

显示 8 / 8 行

服务端操作

ID
Name
Email
Role
Status
1John Doeuser1@example.comAdminActive
2Jane Smithuser2@example.comEditorInactive
3Bob Johnsonuser3@example.comUserPending
4Alice Brownuser4@example.comModeratorActive
5Charlie Wilsonuser5@example.comAdminInactive
6Diana Martinezuser6@example.comEditorPending
7Edward Tayloruser7@example.comUserActive
8Fiona Andersonuser8@example.comModeratorInactive
9George Leeuser9@example.comAdminPending
10Hannah Whiteuser10@example.comEditorActive

显示 10 / 50 行

Server Request Info:
  • Page: 1
  • Search: None
  • Sort: None (None)
  • Total Items: 50

底部栏排序（CSS 变量）

Table bottom bar ordering
ID
Name
Role
1John DoeAdmin
2Jane SmithEditor
3Bob JohnsonUser

显示 3 / 3 行

List bottom bar ordering
  • Task A
  • Task B

显示 2 / 3 行

选择与行操作

批量选择与操作

ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comEditor
5Charlie Wilsoncharlie@example.comUser

显示 5 / 5 行

主从选择 (rowClass)

Order
Customer
Total
Status
1001Ada Lovelace$1,240.00Paid
1002Alan Turing$890.50Pending
1003Grace Hopper$2,415.00Paid
1004Katherine Johnson$540.75Refunded
1005Edsger Dijkstra$1,975.20Paid

Click a row to open its detail — the active row shows the tint + accent bar.

Select an order to see its detail.

行点击处理

ID
Product Name
Category
Price
Stock
Status
1LaptopElectronics$1,29945Available
2Office ChairFurniture$39923Available
3Wireless MouseAccessories$29156Available
4Monitor 27"Electronics$5490Out of Stock
5Desk LampFurniture$7967Available
6KeyboardAccessories$8992Available

显示 6 / 6 行

行操作按钮

ID
Name
Email
Role
Status
Actions
1John Doejohn.doe@example.comAdminActive
2Jane Smithjane.smith@example.comEditorActive
3Bob Johnsonbob.johnson@example.comUserInactive
4Alice Brownalice.brown@example.comEditorActive
5Charlie Wilsoncharlie.wilson@example.comUserActive

显示 5 / 5 行

批量操作（batchActions）

ID
Name
Email
Status
1John Doejohn.doe@example.comActive
2Jane Smithjane.smith@example.comActive
3Bob Johnsonbob.johnson@example.comInactive
4Alice Brownalice.brown@example.comActive
5Charlie Wilsoncharlie.wilson@example.comInactive

显示 5 / 5 行

无关的表单控件

ID
Name
Email
Role
Department
1John Doejohn.doe@example.comAdminIT
2Jane Smithjane.smith@example.comEditorMarketing
3Bob Johnsonbob.johnson@example.comUserSales
4Alice Brownalice.brown@example.comEditorIT
5Charlie Wilsoncharlie.wilson@example.comUserHR

显示 5 / 8 行

Search and rows-per-page are rendered by ng-hub-ui-forms (hub-input / hub-select). Remove the provider and they fall back to native controls.

列、固定与响应式

可展开行与粘性列

ID
Name
Role
Email
Actions
1John DoeAdminjohn@example.com
2Jane SmithEditorjane@example.com
3Bob JohnsonUserbob@example.com
4Alice BrownEditoralice@example.com

显示 4 / 4 行

多个固定列

Scroll horizontally. Two columns pin to the left (ID + Full Name) and two to the right (Salary + Status) — each offset by the width of its sticky neighbours, so they never overlap.
ID
Full Name
Email Address
Department
Position
Office Location
Salary
Status
1John Doejohn.doe@example.comEngineeringSenior DeveloperNew York$120,000Active
2Jane Smithjane.smith@example.comMarketingMarketing ManagerLos Angeles$95,000Active
3Bob Johnsonbob.johnson@example.comSalesSales RepresentativeChicago$75,000On leave
4Alice Brownalice.brown@example.comEngineeringTechnical LeadSan Francisco$140,000Active
5Charlie Wilsoncharlie.wilson@example.comHRHR SpecialistBoston$65,000Active

显示 5 / 5 行

滚动时固定表头

Scroll vertically. Both tables cap the body at 280px and keep the header pinned — the first via [stickyHeader] inside a plain scroll div, the second via the built-in options.scrollable frame.
With [stickyHeader] (any scroll container)
ID
Name
Department
Location
Status
1Employee 1EngineeringNew YorkOn leave
2Employee 2MarketingLondonActive
3Employee 3SalesBerlinActive
4Employee 4HRTokyoActive
5Employee 5EngineeringNew YorkActive
6Employee 6MarketingLondonOn leave
7Employee 7SalesBerlinActive
8Employee 8HRTokyoActive
9Employee 9EngineeringNew YorkActive
10Employee 10MarketingLondonActive

显示 10 / 40 行

With options.scrollable (built-in frame)
ID
Name
Department
Location
Status
1Employee 1EngineeringNew YorkOn leave
2Employee 2MarketingLondonActive
3Employee 3SalesBerlinActive
4Employee 4HRTokyoActive
5Employee 5EngineeringNew YorkActive
6Employee 6MarketingLondonOn leave
7Employee 7SalesBerlinActive
8Employee 8HRTokyoActive
9Employee 9EngineeringNew YorkActive
10Employee 10MarketingLondonActive

显示 10 / 40 行

列可见性

Column Visibility
ID
Product Name
SKU
Category
Price
Stock
Supplier
1LaptopLAP-001Electronics129945TechCorp
2Office ChairCHR-002Furniture39923FurnCo
3Wireless MouseMOU-003Accessories29156TechCorp
4Monitor 27"MON-004Electronics54934ScreenPro
5Desk LampLMP-005Furniture7967LightCo

显示 5 / 5 行

可调整列宽

Tip: Hover over column borders and drag to resize columns. Try resizing the Name and Email columns.
ID
Full Name
Email Address
Department
Position
1John Doejohn.doe@example.comEngineeringSenior Developer
2Jane Smithjane.smith@example.comMarketingMarketing Manager
3Bob Johnsonbob.johnson@example.comSalesSales Representative
4Alice Brownalice.brown@example.comEngineeringTechnical Lead
5Charlie Wilsoncharlie.wilson@example.comHRHR Specialist

显示 5 / 5 行

响应式布局与状态

ID
Name
Role
1John DoeAdmin
2Jane SmithEditor

显示 2 / 2 行

模板与状态

使用模板进行自定义

ID
Name
Role
Status
1John Doe Admin
Active
2Jane Smith Editor
Active
3Bob Johnson User
Inactive

显示 3 / 3 行

动态行样式（rowClass）

ID
Name
Email
Role
Status
1John Doejohn.doe@example.comAdminactive
2Jane Smithjane.smith@example.comEditorinactive
3Bob Johnsonbob.johnson@example.comUserpending
4Alice Brownalice.brown@example.comEditoractive
5Charlie Wilsoncharlie.wilson@example.comUserdeleted

显示 5 / 5 行

空状态与错误状态

ID
Name
Email
Role
1John Doejohn.doe@example.comAdmin
2Jane Smithjane.smith@example.comEditor
3Bob Johnsonbob.johnson@example.comUser

显示 3 / 3 行

默认状态组件

ID
Name
Role
1John DoeAdmin
2Jane SmithEditor
3Bob JohnsonUser

显示 3 / 3 行

列表加载、错误和空状态

  • John Doe
    john.doe@example.com
  • Jane Smith
    jane.smith@example.com
  • Bob Johnson
    bob.johnson@example.com

列表与拖放

连接列表（时间线）

  • 09:00
    Order placed
    Payment confirmed
  • 11:20
    Processing
    Picked from warehouse
  • 14:05
    Shipped
    Handed to courier
  • —
    Out for delivery
    Estimated today

可选择列表

Hover a row. Selectable items show a pointer cursor; tick the checkbox to select.
  • EngAda Lovelace
  • ResearchAlan Turing
  • ArchGrace Hopper
  • DataKatherine Johnson
Selected: 0 — []
Single
One of these, and only one. Picking a row releases the previous one.
  • EngAda Lovelace
  • ResearchAlan Turing
  • ArchGrace Hopper
  • DataKatherine Johnson
Lead:null

卡片式列表

  • MR

    Marta Ruiz

    Product Designer

    Available

    Email: marta.ruiz@example.com

    Phone: +34 600 111 222

  • CV

    Carlos Vega

    Frontend Engineer

    Busy

    Email: carlos.vega@example.com

    Phone: +34 600 333 444

  • LM

    Lucia Moreno

    Engineering Manager

    Available

    Email: lucia.moreno@example.com

    Phone: +34 600 555 666

  • PS

    Pablo Serra

    QA Lead

    Offline

    Email: pablo.serra@example.com

    Phone: +34 600 777 888

嵌套列表

Tree list
  • Documents
    • Reports
      • Q1-2026.pdf
      • Q2-2026.pdf
    • Invoices
  • Media
    • Photos
    • Videos
  • Readme.txt
Cards with nested items
  • Documents
    • Reports
      • Q1-2026.pdf
      • Q2-2026.pdf
    • Invoices
  • Media
    • Photos
    • Videos
  • Readme.txt

拖放重新排序

To do
  • Design the dashboard
  • Implement the API client
  • Write unit tests
  • Review pull requests
Done
  • Set up the project
  • Configure CI

Last event: drag a row by its handle, or focus it and press Space then arrows

整项拖拽（无手柄）

No handle — grab anywhere on a row to drag it.

  • 1
    Intro
    The Standalones
  • 2
    Signals & Slots
    Reactive Trio
  • 3
    Zoneless Nights
    The Standalones
  • 4
    Template Syntax
    Control Flow
  • 5
    Outro
    Reactive Trio

Last event: drag any row, or focus one and press Space then arrows

嵌套列表拖放

Drag files between folders, or reorder within a folder.

  • Documents
    • Reports
      • Q1-2026.pdf
      • Q2-2026.pdf
    • Invoices.xlsx
    • Notes.md
  • Media
    • logo.svg
    • hero.png
  • Readme.txt

Last event: drag a file or folder to reorder it

主题与图标

表格的 CSS 变量

Sunrise Theme
ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comReviewer

显示 4 / 4 行

Midnight Theme
ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comReviewer

显示 4 / 4 行

可主题化的表头与分隔线

Invoice
Client
Amount
Status
INV-1001Acme Corp$3,200Paid
INV-1002Globex$1,750Pending
INV-1003Initech$980Paid
INV-1004Umbrella$5,410Overdue

显示 4 / 4 行

通过标签选择器进行深色重设主题

Re-themed by a bare hub-table tag selector — no!important.
ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comReviewer

可自定义的展开图标

Expand a row. The expander uses custom plus / minus glyphs via --hub-table-icon-caret-up / --hub-table-icon-caret-down.
Product
SKU
Price
Stock
Wireless MouseWM-100$24.99132
Mechanical KeyboardMK-220$89.0047
USB-C HubUH-330$39.5088

显示 3 / 3 行

自定义图标集

Search, sort and expand to see the swapped glyphs. Every icon is a --hub-table-icon-* variable.
Name
Role
Team
Ada LovelaceEngineerCore
Alan TuringResearcherLabs
Grace HopperArchitectPlatform
Katherine JohnsonAnalystData

显示 4 / 4 行

一键主题（mixin）

Code
Name
Owner
A-01AlphaAda
B-02BravoAlan
C-03CharlieGrace

显示 3 / 3 行

列表的 CSS 变量

Forest Theme
  • John DoeProduct Manager
  • Jane SmithEngineer
  • Bob JohnsonDesigner

显示 3 / 5 行

Dusk Theme
  • John DoeProduct Manager
  • Jane SmithEngineer
  • Bob JohnsonDesigner

显示 3 / 5 行

Ocean Theme — one-call hub-list-theme() mixin
  • John DoeProduct Manager
  • Jane SmithEngineer
  • Bob JohnsonDesigner

显示 3 / 5 行

国际化

国际化（i18n）

ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comModerator
5Charlie Wilsoncharlie@example.comAdmin
6Diana Martinezdiana@example.comEditor
7Edward Tayloredward@example.comUser
8Fiona Andersonfiona@example.comModerator
9George Leegeorge@example.comAdmin
10Hannah Whitehannah@example.comEditor
11Ivan Clarkivan@example.comUser
12Julia Scottjulia@example.comModerator

Showing 12 of 12 rows

RTL 布局（从右到左）

ID
Name
Email
Role
1John Doejohn@example.comAdmin
2Jane Smithjane@example.comEditor
3Bob Johnsonbob@example.comUser
4Alice Brownalice@example.comReviewer

显示 4 / 4 行

  • Start the project kickoff
  • Prepare requirements document
  • Review API contract
  • Plan deployment checklist

显示 4 / 4 行

齐平样式 — 列表，而非卡片堆叠

Default — a stack of cards

Each row is its own surface. On a page, that is what separates it from the page.

  • Despacho 1 · Officefrom 900,00 € / month
  • Sala Timple · Meeting roomfrom 90,00 € / day
  • Zona compartida · Coworkingfrom 180,00 € / month
Flush — one list

Inside a dialog the frame is already drawn, so the rows only need a rule between them.

  • Despacho 1 · Officefrom 900,00 € / month
  • Sala Timple · Meeting roomfrom 90,00 € / day
  • Zona compartida · Coworkingfrom 180,00 € / month
The table takes it too

Outer border, radius and head rule go; the row divider and the cell padding stay, because those are what keep a table readable across its columns.

Room
Kind
Rate
Despacho 1Officefrom 900,00 € / month
Sala TimpleMeeting roomfrom 90,00 € / day
Zona compartidaCoworkingfrom 180,00 € / month

选择树形列表，以及点击传递的内容

Tick a building to take its rooms. Tick one room and the building goes indeterminate. Type in the search box to narrow the tree.
  • Building A
    • Meeting room 1
    • Meeting room 2
    • Phone booth
  • Building B
    • Studio
    • Workshop
  • Rooftop
Single, over the same tree
Only rooms carry a radio. A heading is not one of the things to choose.
  • Building A
    • Meeting room 1
    • Meeting room 2
    • Phone booth
  • Building B
    • Studio
    • Workshop
  • Rooftop
Selected:[]
Last click:(none yet)

可编辑——控件呈现为表格

Default — every control brings its own box
Product
Quantity
Unit
u.
box
u.
box
u.
kg
With flushFields — the same controls, read as a sheet
Product
Quantity
Unit
u.
box
u.
box
u.
kg

操作样式

Room
Seats
Actions
Sala Azul8
Sala Verde4
Despacho 122