summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/collections/Querify.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/collections/Querify.md')
-rw-r--r--docs/content/en/functions/collections/Querify.md37
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>
+```