Pagination
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/pagination.go
在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。
package main
import (
"fmt"
"github.com/dyike/keel/ui/core"
"github.com/dyike/keel/ui/el"
"github.com/dyike/keel/ui/kit"
"github.com/dyike/keel/ui/theme"
)
func init() {
registerSection("pagination", "navigation", func() core.Widget {
p := kit.Pagination(195, 10)
compact := kit.Pagination(195, 10).Compact(true).Size(24)
wide := kit.Pagination(1000, 10).VisiblePages(9).Size(36)
wide.SetValue(50)
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
s, e := p.Bounds()
return el.Div().P(24).Gap(8).Items(el.Start).Child(p.Render(cx), el.Text(fmt.Sprintf(demoText("Showing items %d–%d", "显示第 %d–%d 条"), s+1, e)).TextColor(theme.Muted), el.Text(demoText("Compact mode · 24dp", "紧凑模式 · 24dp")), compact.Render(cx), el.Text(demoText("Nine page numbers · 36dp", "九个页码 · 36dp")), wide.Render(cx))
}))
})
}
分页条。
pages := kit.Pagination(total, 20).OnChange(func(p int) { load(p) })
start, end := pages.Bounds() // 当前页的数据范围 [start, end)
- 页码从 1 开始。页数多时,显示首页、末页和当前页附近的页码,中间用省略号代替。
- 第一页时"上一页"禁用,最后一页时"下一页"禁用。
Value()/SetValue(p)(会限制在合法范围内,不触发回调)、SetTotal(n)、Pages()。- "共 N 条""上一页""下一页"来自 locale。
Agent:容器角色 navigation,value 为"当前页/总页数";页码是名为数字的按钮。
验证:go run ./examples/components -section pagination,加 -theme dark 检查深色。
窄容器下总数、页码与前后页按钮自动换行,末页按钮仍可点击。页数和最后一页范围的计算避免整数加法溢出。
Compact(true) 只显示前后页图标按钮,隐藏总数和页码;Agent 仍报告当前页/总页数。false 恢复完整布局,切换不改变当前页。
VisiblePages(n) 设置数字按钮数量上限,不包含省略号和前后页。正数限制在 3–101,以便始终保留首页、当前页和末页;中间窗口随当前页移动。0 恢复原有窗口策略,负数忽略。默认沿用 Keel 原布局(少于八页时全显示),与上游默认五个按钮不同。
Size(dp) 设置按钮高度,正数限制在 16–128dp,0 恢复默认 28dp;负数和非有限值忽略。使用连续尺寸,可选 20/24/28/36dp 对应不同密度。SetDisabled(true) 禁用整条分页;祖先禁用也会生效。程序调用 SetValue/SetTotal 仍更新状态且不触发 OnChange。
pages.VisiblePages(9).Size(36)
compact := kit.Pagination(total, 20).Compact(true).Size(24)
页码按钮使用稳定身份,窗口移动和紧凑模式切换时,仍存在的按钮保留键盘焦点。总页数缩小时当前页会收敛到末页。