From eafc098e7ce285612aab4c23365d215f4d1313b9 Mon Sep 17 00:00:00 2001
From: Matt King <a11yThinker@Gmail.com>
Date: Wed, 27 Jun 2018 00:13:24 -0700
Subject: [PATCH] Editor Menubar Example: Add notes about hover and focus
 movement (pull #711)

For issue #603, modified: examples/menubar/menubar-2/menubar-2.html.
In the accessibility features section, added items 4 and 5 describing the conditions when mouse hover can move focus.
---
 examples/menubar/menubar-2/menubar-2.html | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/examples/menubar/menubar-2/menubar-2.html b/examples/menubar/menubar-2/menubar-2.html
index 4934481bb..81a572a4e 100644
--- a/examples/menubar/menubar-2/menubar-2.html
+++ b/examples/menubar/menubar-2/menubar-2.html
@@ -137,8 +137,21 @@ <h2 id="ex1_label">Example</h2>
     <h2>Accessibility Features</h2>
     <ol>
       <li>Users of assistive technologies can identify which format settings are selected because they are represented by menu item radio and menu item checkbox elements that have a checked state.</li>
-      <li>Disabled menu items are demonstrated in the font size menu, which  includes two disabled menuitems        .</li>
+      <li>Disabled menu items are demonstrated in the font size menu, which  includes two disabled menuitems.</li>
       <li>The down arrow and checked icons are made compatible with high contrast mode and hidden from screen readers by using the CSS <code>content</code> property to render images.</li>
+      <li>
+        Like desktop menubars, submenus open on mouse hover over a parent item in the menubar only if another submenu is already open.
+        That is, if all submenus are closed, a click on a parent menu item is required to display a submenu.
+        Minimizing automatic popups makes exploring with a screen magnifier easier.
+      </li>
+      <li>
+        In general, moving focus in response to mouse hover is avoided in accessible widgets; it causes unexpected context changes for keyboard users.
+        However, like desktop menubars, there are two conditions in this example menubar where focus moves in response to hover in order to help maintain context for users who use both keyboard and mouse:
+        <ol>
+          <li>After a parent menu item in the menubar has been activated and the user hovers over a different parent item in the menubar, focus will follow hover.</li>
+          <li>When a submenu is open and the user hovers over an item in the submenu, focus follows hover.</li>
+        </ol>
+      </li>
     </ol>
   </section>