partials.Include

若部分模板中沒有 return 語句，partial 函數將返回 template.HTML 類型的字串。若包含 return 語句，則 partial 函數可返回任何資料類型。

這裡有三個部分模板的範例：

layouts/
└── partials/
    ├── average.html
    ├── breadcrumbs.html
    └── footer.html

“average” 部分返回一個或多個數字的平均數。我們將數字放入上下文中：

{{ $numbers := slice 1 6 7 42 }}
{{ $average := partial "average.html" $numbers }}

“breadcrumbs” 部分呈現麵包屑導航，需要接收當前頁面的上下文：

{{ partial "breadcrumbs.html" . }}

“footer” 部分呈現網站頁腳。在這個範例中，頁腳不需要存取當前頁面，因此可以省略上下文：

{{ partial "footer.html" }}

你可以在上下文中傳遞任何東西：頁面、頁面集合、純量值、切片或映射。在這個範例中，我們傳遞當前頁面和三個純量值：

{{ $ctx := dict 
  "page" .
  "name" "John Doe" 
  "major" "Finance"
  "gpa" 4.0
}}
{{ partial "render-student-info.html" $ctx }}

然後，在部分模板中：

<p>{{ .name }} 主修 {{ .major }}。</p>
<p>他們的 GPA 為 {{ .gpa }}。</p>
<p>詳情請參見 <a href="{{ .page.RelPermalink }}">此處。</a></p>

要從部分模板中返回一個值，必須在模板的結尾包含一個 return 語句：

{{ $result := "" }}
{{ if math.ModBool . 2 }}
  {{ $result = "even" }}
{{ else }}
  {{ $result = "odd" }}
{{ end }}
{{ return $result }}

請參見細節。

partials.IncludeCached Parent