diff options
Diffstat (limited to 'docs/content/en/functions/querify.md')
-rw-r--r-- | docs/content/en/functions/querify.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/content/en/functions/querify.md b/docs/content/en/functions/querify.md new file mode 100644 index 000000000..9e8c4b83f --- /dev/null +++ b/docs/content/en/functions/querify.md @@ -0,0 +1,36 @@ +--- +title: querify +linktitle: querify +description: Takes a set or slice of key-value pairs and returns a query string to be appended to URLs. +date: 2017-02-01 +publishdate: 2017-02-01 +lastmod: 2017-02-01 +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [urls] +signature: ["querify KEY VALUE [KEY VALUE]...", "querify COLLECTION"] +hugoversion: +deprecated: false +workson: [] +relatedfuncs: [] +aliases: [] +--- + +`querify` takes a set or slice of key-value pairs and returns a [query string](https://en.wikipedia.org/wiki/Query_string) that can be appended to a URL. + +The following examples create a link to a search results page on Google. + +```go-html-template +<a href="https://www.google.com?{{ (querify "q" "test" "page" 3) | safeURL }}">Search</a> + +{{ $qs := slice "q" "test" "page" 3 }} +<a href="https://www.google.com?{{ (querify $qs) | safeURL }}">Search</a> +``` + +Both of these examples render the following HTML: + +```html +<a href="https://www.google.com?page=3&q=test">Search</a> +``` |