range

假值包括 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>集合為空</p>
{{ end }}

在range區塊內：

  • 使用continue語句停止最內層的迭代，並繼續進行下一次迭代。
  • 使用break語句停止最內層的迭代並跳過所有剩餘的迭代。

理解上下文

在頁面模板的頂部，上下文（點）是Page對象。在range區塊內，上下文會被綁定到每一個後續元素。

使用seq函數生成整數切片的這個範例：

{{ range seq 3 }}
  {{ .Title }}
{{ end }}

Hugo將報錯：

無法評估字段 Title 在 int 類型上

錯誤發生是因為我們在整數類型上嘗試使用.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 }} 是 {{ .age }}</p>
{{ end }}

渲染為：

<p>John 是 30</p>
<p>Will 是 28</p>
<p>Joey 是 24</p>

整數或切片的頁面

這段模板代碼：

{{ range where site.RegularPages "Type" "articles" }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

渲染為：

<h2><a href="/articles/article-3/">文章 3</a></h2>
<h2><a href="/articles/article-2/">文章 2</a></h2>
<h2><a href="/articles/article-1/">文章 1</a></h2>

映射

這段模板代碼：

{{ $m := dict "name" "John" "age" 30 }}
{{ range $k, $v := $m }}
  <p>鍵 = {{ $k }} 值 = {{ $v }}</p>
{{ end }}

渲染為：

<p>鍵 = age 值 = 30</p>
<p>鍵 = name 值 = John</p>

與範圍遍歷數組或切片不同，Hugo在遍歷映射時會按鍵排序。

查看 Go 的 text/template 文件以獲得更多資訊。

RawContent PublishDate