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