Pager

Next

返回分页器集合中的下一个分页器。

签名
PAGER.Next
返回类型
page.Pager

这一页解决什么问题

Next 返回页码相邻的下一个分页器(页码更大的那个):实测第 1 页的 .Next 是第 2 页(/page/2/),第 2 页的 .Next 是第 3 页。在最后一页上是 nil——不加保护会让整个站点构建失败。

什么时候用,什么时候别用

该用:

  • 生成「下一页」链接,用 {{ with }} 或 HasNext 保护;
  • 需要下一页的编号或地址:$paginator.Next.PageNumber、$paginator.Next.URL。

别用:

  • 想跳到最后一页 → 用 Last(它永远有值);
  • 想跳到任意一页 → 用 Pagers;
  • 想要文章的下一篇 → 用 Page 的 Next:同名方法在两处的语义完全不同(一处是页码相邻,一处是文章上下篇)。

基本用法

使用 Next 方法在分页器之间构建导航。

go-html-template
{{ $pages := where site.RegularPages "Type" "posts" }}
{{ $paginator := .Paginate $pages }}

{{ range $paginator.Pages }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

{{ with $paginator }}
  <ul>
    {{ with .First }}
      <li><a href="{{ .URL }}">First</a></li>
    {{ end }}
    {{ with .Prev }}
      <li><a href="{{ .URL }}">Previous</a></li>
    {{ end }}
    {{ with .Next }}
      <li><a href="{{ .URL }}">Next</a></li>
    {{ end }}
    {{ with .Last }}
      <li><a href="{{ .URL }}">Last</a></li>
    {{ end }}
  </ul>
{{ end }}

完整示例:上一页 / 下一页(末页自动隐藏「下一页」)

layouts/home.htmlgo-html-template
{{ $paginator := .Paginate (where site.RegularPages "Type" "posts") }}
<nav>
  {{ with $paginator.Prev }}<a href="{{ .URL }}">上一页</a>{{ end }}
  {{ with $paginator.Next }}<a href="{{ .URL }}">下一页</a>{{ end }}
</nav>

测量条件:Hugo 0.167.0 extended,7 篇 posts,[pagination] pagerSize = 3,baseURL = "https://example.org/"。

/(第 1 页)渲染为(with 会留下空行,这里省略):

html
<nav>
  <a href="/page/2/">下一页</a>
</nav>

/page/2/ 渲染为:

html
<nav>
  <a href="/">上一页</a>
  <a href="/page/3/">下一页</a>
</nav>

/page/3/(最后一页)渲染为:

html
<nav>
  <a href="/page/2/">上一页</a>
</nav>

你应当看到什么:只有中间那一页同时有前后两个链接。{{ with }} 之所以必要,是因为末页的 .Next 是 nil——直接输出 {{ $paginator.Next.URL }} 会让构建失败。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,单语言站点,Windows。

情况 结果 是否报错
第 1 页 第 2 页的 pager:URL 为 /page/2/、PageNumber 为 2 否
第 2 页 第 3 页的 pager:URL 为 /page/3/、PageNumber 为 3 否
第 3 页(最后一页) nil(with 判为假,整段跳过) 否(前提是加了 with/if)
单页分页(7 条、每页 100) nil 否
空集合分页 nil 否
不加保护直接取 .URL(最后一页) 构建中断,不产出页面 是:Next is nil; wrap it in if or with: {{ with .Next }}{{ .URL }}{{ end }}
返回类型 page.Pager,可能是 nil —

两栏对照着记:{{ with .Next }} 与 {{ if .HasNext }} 都能防住 nil;区别只是前者把对象绑定为 .,后者不绑定。

常见坑

类别 症状 真因 怎么修
报错看不懂 Next is nil; wrap it in if or with: {{ with .Next }}{{ .URL }}{{ end }} 最后一页的 .Next 是 nil,直接取字段 用 {{ with .Next }} 包住,或改成 {{ if .HasNext }}
没报错但结果不对 内容页的「下一篇」跳到了别处 Pager 的 Next 与 Page 的 Next 同名不同义 内容页用 Page 的 Next
没报错但结果不对 「上一页」与「下一页」指向同一个地址 两个 <a> 都取了 Prev.URL(或都取了 Next.URL) 分别取 $paginator.Prev.URL 与 $paginator.Next.URL

更多排查入口见故障排查。