Page

Paginator

返回对上下文中收到的常规页面集合分页后得到的分页器。

签名
PAGE.Paginator
返回类型
page.Pager

分页(pagination)是指把一个列表页面拆分成两个或多个分页器(pager),每个分页器包含页面集合的一个子集,以及指向其他分页器的导航链接。

每个分页器上的元素个数由你的[项目配置][]决定,默认值为 10。

你可以在首页、section、分类法和术语模板中调用分页。这些模板都会在上下文中接收一个常规页面集合。调用 Paginator 方法时,它会对上下文中收到的页面集合进行分页。

layouts/section.html
{{ range .Paginator.Pages }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
{{ partial "pagination.html" . }}

在上例中,内嵌的分页模板会在分页器之间创建导航链接。