分页
语法
PAGE.Paginate COLLECTION [N]
返回
page.Pager
分页是将列表页面拆分为两个或多个分页器的过程,其中每个分页器都包含页面集合的子集以及指向其他分页器的导航链接。
默认情况下,每个分页器上的元素数量由您的站点配置确定。默认值为 10
。通过在调用 Paginate
方法时提供第二个参数(整数)来覆盖该值。
layouts/_default/list.html
{{ $pages := where .Site.RegularPages "Section" "articles" }}
{{ $pages = $pages.ByTitle }}
{{ range (.Paginate $pages 7).Pages }}
<h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}
{{ template "_internal/pagination.html" . }}
在上面的例子中,我们
- 构建一个页面集合
- 按标题对集合进行排序
- 对集合进行分页,每个分页器包含 7 个元素
- 遍历分页后的页面集合,渲染每个页面的链接
- 调用嵌入式分页模板以创建分页器之间的导航链接