summaryrefslogtreecommitdiffstats
path: root/docs/content/en/methods/menu/Reverse.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/methods/menu/Reverse.md')
-rw-r--r--docs/content/en/methods/menu/Reverse.md51
1 files changed, 51 insertions, 0 deletions
diff --git a/docs/content/en/methods/menu/Reverse.md b/docs/content/en/methods/menu/Reverse.md
new file mode 100644
index 000000000..989132d60
--- /dev/null
+++ b/docs/content/en/methods/menu/Reverse.md
@@ -0,0 +1,51 @@
+---
+title: Reverse
+description: Returns the given menu, reversing the sort order of its entries.
+categories: []
+keywords: []
+action:
+ related: []
+ returnType: navigation.Menu
+ signatures: [MENU.Reverse]
+---
+
+The `Reverse` method returns the given menu, reversing the sort order of its entries.
+
+Consider this menu definition:
+
+{{< code-toggle file=hugo >}}
+[[menu.main]]
+name = 'Services'
+pageRef = '/services'
+weight = 10
+
+[[menu.main]]
+name = 'About'
+pageRef = '/about'
+weight = 20
+
+[[menu.main]]
+name = 'Contact'
+pageRef = '/contact'
+weight = 30
+{{< /code-toggle >}}
+
+To sort the entries by name in descending order:
+
+```go-html-template
+<ul>
+ {{ range .Site.Menus.main.ByName.Reverse }}
+ <li><a href="{{ .URL }}">{{ .Name }}</a></li>
+ {{ end }}
+</ul>
+```
+
+Hugo renders this to:
+
+```html
+<ul>
+ <li><a href="/services/">Services</a></li>
+ <li><a href="/contact">Contact</a></li>
+ <li><a href="/about/">About</a></li>
+</ul>
+```