Pagination

在分页数据中导航。

实时预览

正在加载预览…

参数配置

颜色 color尺寸 size样式 variant禁用 disabled否相邻页数 siblings翻页按钮 controls首尾页 edges

全部字段 16

PaginationOptions

Label

Total

PageSize

Siblings

SiblingCount

ShowControls

ShowEdges

Color

ActiveColor

Variant

ActiveVariant

Size

Disabled

OnChange

UI

Styles · 0

Style

Go 代码

// Inside a view; c is *ui.Context, t is nui.Theme.
// Keep s (example state) outside the view. See the complete example.
nui.Pagination(c.Key("pagination"), t, &s.Page, nui.PaginationOptions{Total: 100, PageSize: 10, SiblingCount: nui.Set(1), ShowControls: nui.Optional[bool]{}, ShowEdges: nui.Optional[bool]{}, Color: nui.ColorDefault, Size: nui.SizeDefault, Variant: nui.VariantDefault, Disabled: false})
ui.Textf(c, "Page %d", s.Page)

使用说明

示例把 100 条记录按每页 10 条分页，页码显示在下方。调整相邻页数量与首尾控制；此组件管理分页交互，数据请求应由应用在页码变化后发起。

API 参考

Pagination

源码

func Pagination(c *ui.Context, t Theme, page *int, o PaginationOptions) ui.Element

PaginationOptions

源码

type PaginationOptions struct {
	Label                     string
	Total, PageSize, Siblings int
	// SiblingCount overrides legacy Siblings and can explicitly request zero.
	SiblingCount            Optional[int]
	ShowControls, ShowEdges Optional[bool]
	Color, ActiveColor      Color
	Variant, ActiveVariant  Variant
	Size                    Size
	Disabled                bool
	OnChange                func(int)
	Decoration
}

字段	类型	说明
`Label`	`string` Go 零值: `""`	控件标签或可访问名称。
`Total`	`int` Go 零值: `0`	总记录数。
`PageSize`	`int` Go 零值: `0`	每页记录数。
`Siblings`	`int` Go 零值: `0`	旧版相邻页数量；SiblingCount 优先。
`SiblingCount`	`Optional[int]` Go 零值: `unset`	当前页两侧的页码数量；支持显式零。
`ShowControls`	`Optional[bool]` Go 零值: `unset`	显示上一页和下一页按钮。
`ShowEdges`	`Optional[bool]` Go 零值: `unset`	显示首尾页入口。
`Color`	`Color` Go 零值: `ColorDefault`	语义颜色；默认值继承主题或组件配色。
`ActiveColor`	`Color` Go 零值: `ColorDefault`	激活状态的颜色覆盖。
`Variant`	`Variant` Go 零值: `VariantDefault`	组件外观样式，支持范围取决于组件。
`ActiveVariant`	`Variant` Go 零值: `VariantDefault`	激活状态的外观覆盖。
`Size`	`Size` Go 零值: `SizeDefault`	组件尺寸；默认值继承主题或组件尺寸。
`Disabled`	`bool` Go 零值: `false`	禁用组件及其交互。
`OnChange`	`func(int)` Go 零值: `nil`	值发生变化时通知应用的回调。
`UI`	`Styles` Go 零值: `zero value`	以部件名称为键覆盖外观和间距。
`Style`	`func(Slot, ui.Element)` Go 零值: `nil`	同步配置当前构建的部件；不要保留 Element。