blob: ea9dfb31aefe1ed86f19daf7e002f21ed10ab075 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
---
title: partials.Include
linkTitle: partial
description: Executes the named partial template. If the partial contains a return statement, returns that value, else returns the rendered output.
categories: [functions]
keywords: []
menu:
docs:
parent: functions
function:
aliases: [partial]
returnType: any
signatures: ['partials.Include LAYOUT [CONTEXT]']
relatedFunctions:
- partials.Include
- partials.IncludeCached
aliases: [/functions/partial]
---
In this example we have three partial templates:
```text
layouts/
└── partials/
├── average.html
├── breadcrumbs.html
└── footer.html
```
The "average" partial returns the average of one or more numbers. We pass the numbers in context:
```go-html-template
{{ $numbers := slice 1 6 7 42 }}
{{ $average := partial "average.html" $numbers }}
```
The "breadcrumbs" partial renders [breadcrumb navigation], and needs to receive the current page in context:
```go-html-template
{{ partial "breadcrumbs.html" . }}
```
The "footer" partial renders the site footer. In this contrived example, the footer does not need access to the current page, so we can omit context:
```go-html-template
{{ partial "breadcrumbs.html" }}
```
You can pass anything in context: a page, a page collection, a scalar value, a slice, or a map. For example:
```go-html-template
{{ $student := dict
"name" "John Doe"
"major" "Finance"
"gpa" 4.0
}}
{{ partial "render-student-info.html" $student }}
```
Then, within the partial template:
```go-html-template
<p>{{ .name }} is majoring in {{ .major }}. Their grade point average is {{ .gpa }}.</p>
```
[breadcrumb navigation]: /content-management/sections/#ancestors-and-descendants
|
