From 885e1ccca9d3ebfb5de9e50e8079637cb8a73b76 Mon Sep 17 00:00:00 2001
From: Kristiyan Kostadinov <crisbeto@abv.bg>
Date: Sun, 16 Aug 2026 10:12:39 +0200
Subject: [PATCH] docs(aria/menu): fix doc string examples

Fixes that the examples in the doc strings didn't include a `value` for the menu items.

Relates #33682.
---
 src/aria/menu/menu-bar.ts     | 8 ++++----
 src/aria/menu/menu-content.ts | 4 ++--
 src/aria/menu/menu-item.ts    | 4 ++--
 src/aria/menu/menu-trigger.ts | 4 ++--
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/aria/menu/menu-bar.ts b/src/aria/menu/menu-bar.ts
index 8c92f1d25996..2f7f8520b1f1 100644
--- a/src/aria/menu/menu-bar.ts
+++ b/src/aria/menu/menu-bar.ts
@@ -39,13 +39,13 @@ import {MENU_COMPONENT} from './menu-tokens';
  * </div>
  *
  * <div ngMenu #fileMenu="ngMenu">
- *   <div ngMenuItem>New</div>
- *   <div ngMenuItem>Open</div>
+ *   <div ngMenuItem value="New">New</div>
+ *   <div ngMenuItem value="Open">Open</div>
  * </div>
  *
  * <div ngMenu #editMenu="ngMenu">
- *   <div ngMenuItem>Cut</div>
- *   <div ngMenuItem>Copy</div>
+ *   <div ngMenuItem value="Cut">Cut</div>
+ *   <div ngMenuItem value="Copy">Copy</div>
  * </div>
  * ```
  *
diff --git a/src/aria/menu/menu-content.ts b/src/aria/menu/menu-content.ts
index ce4ee1f971b2..ced8c54ff320 100644
--- a/src/aria/menu/menu-content.ts
+++ b/src/aria/menu/menu-content.ts
@@ -18,8 +18,8 @@ import {DeferredContent} from '../private';
  * ```html
  * <div ngMenu #myMenu="ngMenu">
  *   <ng-template ngMenuContent>
- *     <div ngMenuItem>Lazy Item 1</div>
- *     <div ngMenuItem>Lazy Item 2</div>
+ *     <div ngMenuItem value="Lazy Item 1">Lazy Item 1</div>
+ *     <div ngMenuItem value="Lazy Item 2">Lazy Item 2</div>
  *   </ng-template>
  * </div>
  * ```
diff --git a/src/aria/menu/menu-item.ts b/src/aria/menu/menu-item.ts
index f19e11a25e82..c4b38d727fac 100644
--- a/src/aria/menu/menu-item.ts
+++ b/src/aria/menu/menu-item.ts
@@ -32,8 +32,8 @@ import type {MenuBar} from './menu-bar';
  *
  * ```html
  * <div ngMenu (itemSelected)="doAction()">
- *   <div ngMenuItem>Action Item</div>
- *   <div ngMenuItem [submenu]="anotherMenu">Submenu Trigger</div>
+ *   <div ngMenuItem value="Action Item">Action Item</div>
+ *   <div ngMenuItem value="Submenu Trigger" [submenu]="anotherMenu">Submenu Trigger</div>
  * </div>
  * ```
  *
diff --git a/src/aria/menu/menu-trigger.ts b/src/aria/menu/menu-trigger.ts
index 7ed57871e656..96546467ddc4 100644
--- a/src/aria/menu/menu-trigger.ts
+++ b/src/aria/menu/menu-trigger.ts
@@ -30,8 +30,8 @@ import type {Menu} from './menu';
  * <button ngMenuTrigger [menu]="myMenu">Open Menu</button>
  *
  * <div ngMenu #myMenu="ngMenu">
- *   <div ngMenuItem>Item 1</div>
- *   <div ngMenuItem>Item 2</div>
+ *   <div ngMenuItem value="Item 1">Item 1</div>
+ *   <div ngMenuItem value="Item 2">Item 2</div>
  * </div>
  * ```
  *