Paginator
分页上下文中接收的常规页面集合。
Syntax
PAGE.Paginator
Returns
page.Pager
分页是将列表页面拆分为两个或更多分页器的过程,其中每个分页器包含页面集合的子集和指向其他分页器的导航链接。
每个分页器上的元素数量由您的 站点配置 确定。默认值为 10。
您可以在 主页、栏目、分类法 和 术语 模板中调用分页。每个都接收 上下文 中的常规页面集合。当您调用 Paginator 方法时,它会分页上下文中接收的页面集合。
layouts/section.html
{{ range .Paginator.Pages }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
{{ partial "pagination.html" . }}在上面的示例中,嵌入的分页模板在分页器之间创建导航链接。
虽然调用简单,但使用 Paginator 方法既不能过滤也不能排序页面集合。它作用于上下文中接收的页面集合。
Paginate 方法更灵活,并且强烈推荐。
请注意,分页的结果会被缓存。一旦调用了 Paginator 或 Paginate 方法,分页后的集合就是不可变的。这些方法的额外调用将无效。