分页导航#

上一页、页码与下一页共同更新当前页。

启用 JavaScript 后可运行预览;源码和安装命令仍可直接查看。

用法
pages := tree.Sub(page, tree.Name("page"))
pagination := components.BeginPagination(canvas, theme, bounds)
pagination.AddPrevious(tree.ID(page, "previous"), "Previous", current == 1)
pagination.AddPage(pages.At(0), "1", current == 1)
pagination.AddPage(pages.At(1), "2", current == 2)
pagination.AddPage(pages.At(2), "3", current == 3)
pagination.AddEllipsis()
pagination.AddPage(pages.At(4), "8", current == 8)
pagination.AddNext(tree.ID(page, "next"), "Next", current == 8)
if index, ok := canvas.ClickedIn(pages); ok {
    current = int32(index + 1)
    if index == 4 {
        current = 8
    }
}

边界状态#

第一页禁用上一页,并保留省略号。

启用 JavaScript 后可运行预览;源码和安装命令仍可直接查看。

用法
pages := tree.Sub(page, tree.Name("page"))
current := int32(1)
pagination := components.BeginPagination(canvas, theme, bounds)
pagination.AddPrevious(tree.ID(page, "previous"), "Previous", current == 1)
pagination.AddPage(pages.At(0), "1", current == 1)
pagination.AddPage(pages.At(1), "2", current == 2)
pagination.AddPage(pages.At(2), "3", current == 3)
pagination.AddEllipsis()
pagination.AddPage(pages.At(4), "8", current == 8)
pagination.AddNext(tree.ID(page, "next"), "Next", current == 8)

安装

将组件源码复制到自己的项目,直接修改。

仓库命令
go run ./cmd/viva add --out ./components/local pagination

源码组件用法#

此预览直接调用生产 Go 组件。稳定 ID、值与打开状态仍由应用持有;组件只负责绘制并声明交互语义。

  • 标题旁的源码链接列出了全部选项与视觉决策。
  • 请使用原生命令验证系统文本、焦点、无障碍与平台集成。
  • 浏览器预览验证共享布局和场景行为,不代表原生性能。

验证边界#

示例覆盖当前 API 的代表性状态,但不表示每个桌面后端都已完成真机验证。

键盘操作

Tab 在控件间移动;Ctrl/⌘ K 搜索组件。进入预览后,键盘事件由 Go 运行时处理。