partials.IncludeCached
若部分模板中沒有 return
語句,partialCached
函數將返回 template.HTML
類型的字串。若包含 return
語句,則 partialCached
函數可返回任何資料類型。
partialCached
函數對於不需要每次重新渲染的複雜模板提供顯著的性能提升。
這是最簡單的用法:
{{ partialCached "footer.html" . }}
傳遞額外的參數給 partialCached
來創建快取部分的變體。例如,如果你有一個複雜的部分模板,並且它在同一區段的頁面間應該是一樣的,那麼就可以基於區段傳遞變體,以便每個區段只渲染一次該部分模板:
{{ partialCached "footer.html" . .Section }}
根據需要,傳遞任意資料類型的額外參數來創建唯一的變體:
{{ partialCached "footer.html" . .Params.country .Params.province }}
變體參數不會提供給基礎的部分模板,它們僅用來創建唯一的快取鍵。
若要從部分模板中返回值,必須只包含一個 return
語句,並且放在模板的末尾:
{{ $result := "" }}
{{ if math.ModBool . 2 }}
{{ $result = "even" }}
{{ else }}
{{ $result = "odd" }}
{{ end }}
{{ return $result }}
請參見細節。