54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# 062 Pagination 分页
|
||
|
||
## 用途
|
||
|
||
在分页数据之间移动：页码、上一页、下一页、页容量选择与跳页。总数变化后，超出范围的页码自动修正到最后一页并报告变化。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
if mujica.Pagination(c, &page, &size, mujica.PaginationOptions{Total: 420, PageSizes: []int{10, 20, 50}, Jump: true}).Changed() {
|
||
load(page, size)
|
||
}
|
||
```
|
||
|
||
签名：`func Pagination(c *ui.Context, page, pageSize *int, opts PaginationOptions) PaginationResult`
|
||
|
||
## 参数
|
||
|
||
`page`：当前页，从 1 开始；每帧被限制在 `[1, 总页数]`。`pageSize`：每页条数，必须为正，否则 panic。
|
||
|
||
`PaginationOptions`
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| `Total` | `int` | 0 | 记录总数；为负 panic。为 0 时仍显示 1 页。 |
|
||
| `PageSizes` | `[]int` | nil | 可选的页容量；nil 隐藏选择器。非 nil 时须包含 `*pageSize`，否则 panic。 |
|
||
| `Jump` | `bool` | false | 显示跳页输入框。 |
|
||
| `Siblings` | `int` | 0（即 1） | 当前页两侧显示的页码数；为负 panic。 |
|
||
| `Disabled` | `bool` | false | 整体禁用。 |
|
||
|
||
返回 `PaginationResult`，内嵌 `*ui.Element`。
|
||
|
||
## 状态
|
||
|
||
- 当前页：Accent 填充、OnAccent 文字、600 字重，名称附“当前”。
|
||
- 页码按钮：Border 细边框，悬停 SurfaceHover 与 ControlBorder 边框；首页时“上一页”禁用，末页时“下一页”禁用。
|
||
- 页码多时首尾保留，中间以“…”省略，按钮数固定为 `2×Siblings+5`，位置稳定。
|
||
- 跳页错误：输入非数字或超出范围时边框变为 Danger，并在旁显示有效范围；输入保留，可直接修改。
|
||
- 修改页容量时，保持原页第一条记录可见。
|
||
|
||
## 事件
|
||
|
||
- `Changed()`：本帧页码或页容量改变（用户操作或总数变化导致的修正）。
|
||
|
||
## 键盘操作
|
||
|
||
- 页码按钮组是一个 Tab 停靠点：←/→ 移动，Home / End 到两端，Enter 或 Space 跳到该页。
|
||
- 页容量：↑/↓ 打开并移动，Enter 选择，Escape 关闭。
|
||
- 跳页框：输入页码后按 Enter。
|
||
|
||
## 限制
|
||
|
||
- 页容量选择基于 MyGo `SelectBase`，弹层由 MujicaUI 绘制。
|