diff options
Diffstat (limited to 'docs/content/en/functions/collections/Querify.md')
-rw-r--r-- | docs/content/en/functions/collections/Querify.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/content/en/functions/collections/Querify.md b/docs/content/en/functions/collections/Querify.md new file mode 100644 index 000000000..c94d51133 --- /dev/null +++ b/docs/content/en/functions/collections/Querify.md @@ -0,0 +1,37 @@ +--- +title: collections.Querify +linkTitle: querify +description: Takes a set or slice of key-value pairs and returns a query string to be appended to URLs. +categories: [functions] +keywords: [] +menu: + docs: + parent: functions +function: + aliases: [querify] + returnType: string + signatures: + - collections.Querify KEY VALUE [KEY VALUE]... + - collections.Querify COLLECTION +relatedFunctions: + - collections.Querify + - urlquery +aliases: [/functions/querify] +--- + +`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> +``` |