range
语法
range COLLECTION
假值包括 false、0、任何 nil 指针或接口值、任何长度为零的数组、切片、映射或字符串，以及零 time.Time 值。
其他一切都为真值。
{{ $s := slice "foo" "bar" "baz" }}
{{ range $s }}
{{ . }} → foo bar baz
{{ end }}
与 else 语句一起使用
{{ $s := slice "foo" "bar" "baz" }}
{{ range $s }}
<p>{{ . }}</p>
{{ else }}
<p>The collection is empty</p>
{{ end }}
在 range 代码块中
理解上下文
在页面模板的顶部，上下文（点）是一个 Page 对象。在 range 代码块中，上下文绑定到每个连续的元素。
使用以下人为设计的示例，该示例使用 seq 函数生成整数切片
{{ range seq 3 }}
{{ .Title }}
{{ end }}
Hugo 将抛出错误
can't evaluate field Title in type int
发生错误的原因是我们试图在整数而不是 Page 对象上使用 .Title 方法。在 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 }}">{{ .LinkTitle }}</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>
映射
此模板代码
{{ $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 文档。