SxPagination (分页器)

  • Implemented

数据分页导航组件。对齐 Microsoft Fluent UI Blazor Pagination (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。

使用场景

  • 表格或列表分页
  • 结果集导航
  • 数据列表分页控制

约束说明

  • ItemsPerPage 需大于 0。
  • SelectedPageIndex 为 0-based。

行为说明

  • 点击页码更新 SelectedPageIndex
  • 上一页/下一页根据边界禁用。

API

Parameters (参数)

状态 参数名 类型 默认值 描述
Implemented TotalItems int 0 总条目数量。
Implemented ItemsPerPage int 10 每页数量。
Implemented SelectedPageIndex int 0 当前页索引。
Implemented SelectedPageIndexChanged EventCallback<int> - 页码变化回调。
Implemented Disabled (继承) bool false 禁用状态。
Implemented Loading (继承) bool false 加载状态。
Implemented Id (继承) string? null 组件 Id。
Implemented Class (继承) string? null CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 额外属性。

Events (事件)

状态 事件名 类型 描述
Implemented SelectedPageIndexChanged EventCallback<int> 页码改变时触发。

示例

<SxPagination TotalItems="120" ItemsPerPage="10" @bind-SelectedPageIndex="_page" />

参考设计 (References)