数据分页导航组件。对齐 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)