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 方法,分頁後的集合就是不可變的。這些方法的額外調用將無效。