summaryrefslogtreecommitdiffstats
path: root/docs/content/en/methods/page/HasMenuCurrent.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/methods/page/HasMenuCurrent.md')
-rw-r--r--docs/content/en/methods/page/HasMenuCurrent.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/content/en/methods/page/HasMenuCurrent.md b/docs/content/en/methods/page/HasMenuCurrent.md
new file mode 100644
index 000000000..68b645905
--- /dev/null
+++ b/docs/content/en/methods/page/HasMenuCurrent.md
@@ -0,0 +1,31 @@
+---
+title: HasMenuCurrent
+description: Reports whether the given page object matches the page object associated with one of the child menu entries under the given menu entry in the given menu.
+categories: []
+keywords: []
+action:
+ related:
+ - methods/page/IsMenuCurrent
+ returnType: bool
+ signatures: [PAGE.HasMenuCurrent MENU MENUENTRY]
+aliases: [/functions/hasmenucurrent]
+---
+
+If the page object associated with the menu entry is a section, this method also returns `true` for any descendant of that section.
+
+```go-html-template
+{{ $currentPage := . }}
+{{ range site.Menus.main }}
+ {{ if $currentPage.IsMenuCurrent .Menu . }}
+ <a class="active" aria-current="page" href="{{ .URL }}">{{ .Name }}</a>
+ {{ else if $currentPage.HasMenuCurrent .Menu . }}
+ <a class="ancestor" aria-current="true" href="{{ .URL }}">{{ .Name }}</a>
+ {{ else }}
+ <a href="{{ .URL }}">{{ .Name }}</a>
+ {{ end }}
+{{ end }}
+```
+
+See [menu templates] for a complete example.
+
+[menu templates]: /templates/menu-templates/#example