safe.HTMLAttr
语法
safe.HTMLAttr INPUT
返回值
template.HTMLAttr
别名
safeHTMLAttr
简介
Hugo 使用 Go 的 text/template 和 html/template 包。
text/template 包实现了用于生成文本输出的数据驱动模板，而 html/template 包实现了用于生成 HTML 输出（安全防范代码注入）的数据驱动模板。
默认情况下，Hugo 在渲染 HTML 文件时使用 html/template 包。
为了生成安全防范代码注入的 HTML 输出，html/template 包会在某些上下文中转义字符串。
用法
使用 safe.HTMLAttr 函数封装来自可信来源的 HTML 属性。
使用此类型存在安全风险：封装的内容应来自可信来源，因为它将逐字包含在模板输出中。
有关详细信息，请参阅 Go 文档。
示例
没有安全声明
{{ with .Date }}
{{ $humanDate := time.Format "2 Jan 2006" . }}
{{ $machineDate := time.Format "2006-01-02T15:04:05-07:00" . }}
<time datetime="{{ $machineDate }}">{{ $humanDate }}</time>
{{ end }}
Hugo 将以上内容渲染为
<time datetime="2024-05-26T07:19:55+02:00">26 May 2024</time>
要将键值对声明为安全
{{ with .Date }}
{{ $humanDate := time.Format "2 Jan 2006" . }}
{{ $machineDate := time.Format "2006-01-02T15:04:05-07:00" . }}
<time {{ printf "datetime=%q" $machineDate | safeHTMLAttr }}>{{ $humanDate }}</time>
{{ end }}
Hugo 将以上内容渲染为
<time datetime="2024-05-26T07:19:55+02:00">26 May 2024</time>