From 61f23f6cc468636c59705a87345f6973a71f52ee Mon Sep 17 00:00:00 2001
From: Zach Arend <zachzach@google.com>
Date: Tue, 11 Jul 2023 22:53:02 +0000
Subject: [PATCH] docs(material/menu): require only static content and
 MenuItems in popup

Update a11y documentation for MatMenu. REquest that MatMenu should not
contain interactive controls, aside from MatMenuItem.

Add clarification for the supported configurations of MatMenu. A common
accessibility mistake is to nest interactive controls inside of a menu
popup.

Addresses #27426
---
 src/material/menu/menu.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/material/menu/menu.md b/src/material/menu/menu.md
index a11581ee3c5d..55115702f62b 100644
--- a/src/material/menu/menu.md
+++ b/src/material/menu/menu.md
@@ -115,3 +115,5 @@ Angular Material does not support the `menuitemcheckbox` or `menuitemradio` role
 
 Always provide an accessible label via `aria-label` or `aria-labelledby` for any menu
 triggers or menu items without descriptive text content.
+
+MatMenu should not contain any interactive controls aside from MatMenuItem.