partials.IncludeCached
语法
partials.IncludeCached LAYOUT CONTEXT [VARIANT...]
返回值
any
别名
partialCached
如果没有 return
语句,partialCached
函数将返回类型为 template.HTML
的字符串。使用 return
语句,partialCached
函数可以返回任何数据类型。
对于不需要在每次调用时重新渲染的复杂模板,partialCached
函数可以显著提高性能。
这是最简单的用法
{{ partialCached "footer.html" . }}
将其他参数传递给 partialCached
以创建缓存局部模板的变体。例如,如果您有一个复杂的局部模板,该模板在同一部分中的页面渲染时应相同,则使用基于部分的变体,以便每个部分仅渲染一次局部模板
partial-cached-example.html
{{ 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 }}
请参阅 详细信息。