Merge commit 'e509cac533600cf4fa8382c9cdab78ddd82db688'

docs/content/en/functions/go-template/range.md

@@ -0,0 +1,159 @@
+---
+title: range
+description: Iterates over slices, maps, and page collections.
+categories: [functions]
+keywords: []
+menu:
+  docs:
+    parent: functions
+function:
+  aliases: []
+  returnType: 
+  signatures: [range COLLECTION]
+relatedFunctions:
+  - with
+  - range
+aliases: [/functions/range]
+toc: true
+---
+
+{{% readfile file="/functions/_common/go-template-functions.md" %}}
+
+## Slices
+
+Template:
+
+```go-html-template
+{{ $s := slice "foo" "bar" "baz" }}
+{{ range $s }}
+  <p>{{ . }}</p>
+{{ end }}
+```
+
+Result:
+
+```html
+<p>foo</p>
+<p>bar</p>
+<p>baz</p>
+```
+
+Template:
+
+```go-html-template
+{{ $s := slice "foo" "bar" "baz" }}
+{{ range $v := $s }}
+  <p>{{ $v }}</p>
+{{ end }}
+```
+
+Result:
+
+```html
+<p>foo</p>
+<p>bar</p>
+<p>baz</p>
+```
+
+Template:
+
+```go-html-template
+{{ $s := slice "foo" "bar" "baz" }}
+{{ range $k, $v := $s }}
+  <p>{{ $k }}: {{ $v }}</p>
+{{ end }}
+```
+
+Result:
+
+```html
+<p>0: foo</p>
+<p>1: bar</p>
+<p>2: baz</p>
+```
+
+## Maps
+
+Template:
+
+```go-html-template
+{{ $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 }}
+```
+
+Result:
+
+```html
+<p>John is 30</p>
+<p>Will is 28</p>
+<p>Joey is 24</p>
+```
+
+## Page collections
+
+Template:
+
+```go-html-template
+{{ range where site.RegularPages "Type" "articles" }}
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+{{ end }}
+```
+
+Result:
+
+```html
+<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>
+```
+
+## Break
+
+Use the `break` statement to stop the innermost iteration and bypass all remaining iterations.
+
+Template:
+
+```go-html-template
+{{ $s := slice "foo" "bar" "baz" }}
+{{ range $s }}
+  {{ if eq . "bar" }}
+    {{ break }}
+  {{ end }}
+  <p>{{ . }}</p>
+{{ end }}
+```
+
+Result:
+
+```html
+<p>foo</p>
+```
+
+## Continue
+
+Use the `continue` statement to stop the innermost iteration and continue to the next iteration.
+
+Template:
+
+```go-html-template
+{{ $s := slice "foo" "bar" "baz" }}
+{{ range $s }}
+  {{ if eq . "bar" }}
+    {{ continue }}
+  {{ end }}
+  <p>{{ . }}</p>
+{{ end }}
+```
+
+Result:
+
+```html
+<p>foo</p>
+<p>baz</p>
+```