From 2af725faeba588d21a77b3277e18aaf11c4797ba Mon Sep 17 00:00:00 2001
From: nod_ <nod_@598310.no-reply.drupal.org>
Date: Tue, 30 Apr 2024 02:46:18 +0900
Subject: [PATCH] Issue #3443869 by kostyashupenko, smustgrave: Add @file
 documentation to menu-region--footer.html.twig template

(cherry picked from commit 3f7d28668cd120579de371554257bb42a32278f0)
---
 .../templates/menu-region--footer.html.twig   | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/core/modules/navigation/templates/menu-region--footer.html.twig b/core/modules/navigation/templates/menu-region--footer.html.twig
index f7f992d2e42b..0139d6919b4e 100644
--- a/core/modules/navigation/templates/menu-region--footer.html.twig
+++ b/core/modules/navigation/templates/menu-region--footer.html.twig
@@ -1,3 +1,27 @@
+{#
+/**
+ * @file
+ * Default theme implementation to display the navigation footer menu.
+ *
+ * Available variables:
+ * - menu_name: The machine name of the user menu.
+ * - help: TRUE if "Help" module is enabled.
+ * - title: A name of account.
+ * - items: A nested list of menu items. Each menu item contains:
+ *   - attributes: HTML attributes for the menu item.
+ *   - below: The menu item child items.
+ *   - title: The menu link title.
+ *   - url: The menu link URL, instance of \Drupal\Core\Url
+ *   - localized_options: Menu link localized options.
+ *   - is_expanded: TRUE if the link has visible children within the current
+ *     menu tree.
+ *   - is_collapsed: TRUE if the link has children within the current menu tree
+ *     that are not currently visible.
+ *   - in_active_trail: TRUE if the link is in the active trail.
+ *
+ * @ingroup themeable
+ */
+#}
 {% set menu_heading_id = 'menu--' ~ menu_name|clean_unique_id %}
 <div class="admin-toolbar__item">
   <h4 id="{{ menu_heading_id }}" class="toolbar-block__title visually-hidden focusable">{{ title }}</h4>
-- 
GitLab