HasPrev
报告当前分页器之前是否还有分页器。
这一页解决什么问题
HasPrev 报告当前分页器之前是否还有分页器——首页为 false,其余页为 true(实测 3 页的站点上分别是 false、true、true)。它回答的是「要不要渲染『上一页』按钮」,而 Prev 回答的是「上一页在哪」。
两者配合使用最稳:{{ if .HasPrev }} 里再取 {{ .Prev.URL }}——实测这样写不会碰到 nil。它与 {{ with .Prev }} 效果等价,上游两段示例都保留。
什么时候用,什么时候别用
该用:
- 决定是否渲染「上一页」按钮;
- 判断当前是否已经在第一页(首页为
false)。
别用:
- 需要上一页的地址或编号 → 用
Prev(但要自己防 nil); - 判断是否为第一页却用
First→ 它永远有值,判断不出来; - 想数页码 → 用
PageNumber。
基本用法
使用 HasPrev 方法在分页器之间构建导航。
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 }}
{{ if .HasPrev }}
<li><a href="{{ .Prev.URL }}">Previous</a></li>
{{ end }}
{{ if .HasNext }}
<li><a href="{{ .Next.URL }}">Next</a></li>
{{ end }}
{{ with .Last }}
<li><a href="{{ .URL }}">Last</a></li>
{{ end }}
</ul>
{{ end }}也可以不使用 HasPrev 方法,写成下面这样:
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 }}完整示例:用 HasPrev 控制「上一页」按钮
layouts/home.htmlgo-html-template
{{ $paginator := .Paginate (where site.RegularPages "Type" "posts") }}
<nav>
{{ if $paginator.HasPrev }}<a href="{{ $paginator.Prev.URL }}">上一页</a>{{ end }}
{{ if $paginator.HasNext }}<a href="{{ $paginator.Next.URL }}">下一页</a>{{ end }}
</nav>测量条件:Hugo 0.167.0 extended,7 篇 posts,[pagination] pagerSize = 3,baseURL = "https://example.org/"。三个分页页分别渲染为(if 会留下空行,这里省略):
html
<nav>
<a href="/page/2/">下一页</a>
</nav>html
<nav>
<a href="/">上一页</a>
<a href="/page/3/">下一页</a>
</nav>html
<nav>
<a href="/page/2/">上一页</a>
</nav>你应当看到什么:首页没有「上一页」,末页没有「下一页」。实测这段模板与用 {{ with .Prev }} / {{ with .Next }} 写出来的产物逐字节相同,选哪种只看你更想强调「有没有」还是「取对象」。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点,Windows。
| 情况 | 结果 | 是否报错 |
|---|---|---|
| 第 1 页 | false |
否 |
| 第 2、3 页 | true |
否 |
| 单页分页(7 条、每页 100) | false |
否 |
| 空集合分页 | false |
否 |
在 if 里访问 {{ .Prev.URL }} |
为真时才求值,实测安全,不会碰到 nil | 否 |
| 返回类型 | bool,永远不是 nil,不会因缺少上一页而报错 |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 报错看不懂 | Prev is nil; wrap it in if or with: {{ with .Prev }}{{ .URL }}{{ end }} |
在 if/with 之外直接取了 .Prev.URL |
放进 {{ if .HasPrev }} 或 {{ with .Prev }} 里 |
| 没报错但结果不对 | 首页也渲染出「上一页」 | 把 HasPrev 与 HasNext 写反了 |
打印 {{ .HasPrev }} {{ .HasNext }} 核对:首页应为 false true |
| 没报错但结果不对 | 只有一页内容时也显示分页条 | 单页分页时两个布尔都是 false,但导航容器仍渲染了 |
用 TotalPages 判断要不要渲染整个容器 |
| 没报错但结果不对 | 用 {{ with .First }} 判断首页,永远进分支 |
.First 永远有值 |
用 HasPrev 或 PageNumber 判断 |
更多排查入口见故障排查。