HUGO
Menu
GitHub 87548 stars Mastodon

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 方法更灵活,并且强烈推荐。

请注意,分页的结果会被缓存。一旦调用了 PaginatorPaginate 方法,分页后的集合就是不可变的。这些方法的额外调用将无效。


Last updated: January 1, 0001
Improve this page