range
Syntax
range COLLECTION
在 Go 模板中,Falsy 值包括 false
,0
,任何 nil 指针或接口值,以及任何长度为零的数组、切片、映射或字符串。其余所有值都为 Truhty 值。
{{ $s := slice "foo" "bar" "baz" }}
{{ range $var }}
{{ . }} → foo bar baz
{{ end }}
与 else
语句一起使用:
{{ $s := slice "foo" "bar" "baz" }}
{{ range $s }}
<p>{{ . }}</p>
{{ else }}
<p>集合为空</p>
{{ end }}
在 range 块内部:
理解上下文
在页面模板的顶部,context(即点)是一个Page
对象。在range
块中,上下文将绑定到每个连续的元素。
下面是一个使用 seq
函数生成整数切片的虚构示例:
{{ range seq 3 }}
{{ .Title }}
{{ end }}
Hugo 将抛出一个错误:
无法在 int 类型上评估字段 Title
这个错误发生是因为我们试图在整数上使用.Title
方法,而不是Page
对象。在range
块中,如果我们想要渲染页面标题,我们需要获取传递给模板的上下文。
这个模板将会多次渲染页面标题:
{{ range seq 3 }}
{{ $.Title }}
{{ end }}
数组或切片的标量
以下模板代码:
{{ $s := slice "foo" "bar" "baz" }}
{{ range $s }}
<p>{{ . }}</p>
{{ end }}
将被渲染为:
<p>foo</p>
<p>bar</p>
<p>baz</p>
以下模板代码:
{{ $s := slice "foo" "bar" "baz" }}
{{ range $v := $s }}
<p>{{ $v }}</p>
{{ end }}
将被渲染为:
<p>foo</p>
<p>bar</p>
<p>baz</p>
以下模板代码:
{{ $s := slice "foo" "bar" "baz" }}
{{ range $k, $v := $s }}
<p>{{ $k }}: {{ $v }}</p>
{{ end }}
将被渲染为:
<p>0: foo</p>
<p>1: bar</p>
<p>2: baz</p>
数组或切片的映射
以下模板代码:
{{ $m := slice
(dict "name" "John" "age" 30)
(dict "name" "Will" "age" 28)
(dict "name" "Joey" "age" 24)
}}
{{ range $m }}
<p>{{ .name }} is {{ .age }}</p>
{{ end }}
将被渲染为:
<p>John is 30</p>
<p>Will is 28</p>
<p>Joey is 24</p>
页面数组或切片
以下模板代码:
{{ range where site.RegularPages "Type" "articles" }}
<h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}
将被渲染为:
<h2><a href="/articles/article-3/">Article 3</a></h2>
<h2><a href="/articles/article-2/">Article 2</a></h2>
<h2><a href="/articles/article-1/">Article 1</a></h2>
映射(map)
以下模板代码:
{{ $m := dict "name" "John" "age" 30 }}
{{ range $k, $v := $m }}
<p>key = {{ $k }} value = {{ $v }}</p>
{{ end }}
将被渲染为:
<p>key = age value = 30</p>
<p>key = name value = John</p>
与遍历数组或切片不同,Hugo 在遍历映射时按键进行排序。
详见 Go 的 text/template 文档获取更多信息。