mirror of
https://github.com/gohugoio/hugoDocs.git
synced 2025-10-15 05:25:43 -04:00
4e0bca2b1e
We need to rework the whole template func docs and, while a good idea, this does not fit into that.
36 lines
1008 B
Markdown
36 lines
1008 B
Markdown
---
|
|
title: safeHTMLAttr
|
|
# linktitle: safeHTMLAttr
|
|
description: Declares the provided string as a "safe" HTML attribute.
|
|
godocref: https://golang.org/src/html/template/content.go?s=1661:1676#L33
|
|
date: 2017-02-01
|
|
publishdate: 2017-02-01
|
|
lastmod: 2017-02-01
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: "functions"
|
|
#tags: [strings]
|
|
signature: ["safeHTMLAttr INPUT"]
|
|
workson: []
|
|
hugoversion:
|
|
relatedfuncs: []
|
|
deprecated: false
|
|
aliases: []
|
|
---
|
|
|
|
`safeHTMLAttr` declares the provided string as a "safe" HTML attribute
|
|
from a trusted source (e.g., ` dir="ltr"`) to prevent Go html/template from filtering it as unsafe.
|
|
|
|
Example: Given a site-wide `config.toml` that contains this menu entry:
|
|
|
|
```toml
|
|
[[menu.main]]
|
|
name = "IRC: #golang at freenode"
|
|
url = "irc://irc.freenode.net/#golang"
|
|
```
|
|
|
|
* <span class="bad">`<a href="{{ .URL }}">` → `<a href="#ZgotmplZ">`</span>
|
|
* <span class="good">`<a {{ printf "href=%q" .URL | safeHTMLAttr }}>` → `<a href="irc://irc.freenode.net/#golang">`</span>
|
|
|