Keel v0.5.1 English GitHub

Pagination

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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)

页码按钮使用稳定身份,窗口移动和紧凑模式切换时,仍存在的按钮保留键盘焦点。总页数缩小时当前页会收敛到末页。