Optionally, the focus movement may wrap inside a single cell or within the grid itself.
diff --git a/content/patterns/landmarks/examples/at.html b/content/patterns/landmarks/examples/at.html
index ccec4ccfaa..97d1da8759 100644
--- a/content/patterns/landmarks/examples/at.html
+++ b/content/patterns/landmarks/examples/at.html
@@ -192,7 +192,7 @@
diff --git a/content/patterns/listbox/examples/listbox-rearrangeable.html b/content/patterns/listbox/examples/listbox-rearrangeable.html
index bce043d135..22152fcd18 100644
--- a/content/patterns/listbox/examples/listbox-rearrangeable.html
+++ b/content/patterns/listbox/examples/listbox-rearrangeable.html
@@ -243,8 +243,8 @@
Multiple selection keys supported in example 2changes the selection state of the focused option .
- Shift + Down Arrow |
+ Shift + Down Arrow |
Moves focus to and selects the next option. |
- Shift + Up Arrow |
+ Shift + Up Arrow |
Moves focus to and selects the previous option. |
- Control + Shift + Home |
+ Control + Shift + Home |
Selects from the focused option to the beginning of the list. |
- Control + Shift + End |
+ Control + Shift + End |
Selects from the focused option to the end of the list. |
- Control + A (All Platforms)
+ Control + A (All Platforms)
Command-A (macOS)
|
diff --git a/content/patterns/listbox/listbox-pattern.html b/content/patterns/listbox/listbox-pattern.html
index 3988a66f2a..f17aab71bf 100644
--- a/content/patterns/listbox/listbox-pattern.html
+++ b/content/patterns/listbox/listbox-pattern.html
@@ -109,19 +109,19 @@ Keyboard Interaction
Recommended selection model -- holding modifier keys is not necessary:
- Space: changes the selection state of the focused option.
- - Shift + Down Arrow (Optional): Moves focus to and toggles the selected state of the next option.
- - Shift + Up Arrow (Optional): Moves focus to and toggles the selected state of the previous option.
- - Shift + Space (Optional): Selects contiguous items from the most recently selected item to the focused item.
+ - Shift + Down Arrow (Optional): Moves focus to and toggles the selected state of the next option.
+ - Shift + Up Arrow (Optional): Moves focus to and toggles the selected state of the previous option.
+ - Shift + Space (Optional): Selects contiguous items from the most recently selected item to the focused item.
-
- Control + Shift + Home (Optional): Selects the focused option and all options up to the first option.
+ Control + Shift + Home (Optional): Selects the focused option and all options up to the first option.
Optionally, moves focus to the first option.
-
- Control + Shift + End (Optional): Selects the focused option and all options down to the last option.
+ Control + Shift + End (Optional): Selects the focused option and all options down to the last option.
Optionally, moves focus to the last option.
-
- Control + A (Optional): Selects all options in the list.
+ Control + A (Optional): Selects all options in the list.
Optionally, if all options are selected, it may also unselect all options.
@@ -129,22 +129,22 @@ Keyboard Interaction
Alternative selection model -- moving focus without holding a Shift or Control modifier unselects all selected options except the focused option:
- - Shift + Down Arrow: Moves focus to and toggles the selection state of the next option.
- - Shift + Up Arrow: Moves focus to and toggles the selection state of the previous option.
- - Control + Down Arrow: Moves focus to the next option without changing its selection state.
- - Control + Up Arrow: Moves focus to the previous option without changing its selection state.
- - Control + Space Changes the selection state of the focused option.
- - Shift + Space (Optional): Selects contiguous items from the most recently selected item to the focused item.
+ - Shift + Down Arrow: Moves focus to and toggles the selection state of the next option.
+ - Shift + Up Arrow: Moves focus to and toggles the selection state of the previous option.
+ - Control + Down Arrow: Moves focus to the next option without changing its selection state.
+ - Control + Up Arrow: Moves focus to the previous option without changing its selection state.
+ - Control + Space Changes the selection state of the focused option.
+ - Shift + Space (Optional): Selects contiguous items from the most recently selected item to the focused item.
-
- Control + Shift + Home (Optional): Selects the focused option and all options up to the first option.
+ Control + Shift + Home (Optional): Selects the focused option and all options up to the first option.
Optionally, moves focus to the first option.
-
- Control + Shift + End (Optional): Selects the focused option and all options down to the last option.
+ Control + Shift + End (Optional): Selects the focused option and all options down to the last option.
Optionally, moves focus to the last option.
-
- Control + A (Optional): Selects all options in the list.
+ Control + A (Optional): Selects all options in the list.
Optionally, if all options are selected, it may also unselect all options.
diff --git a/content/patterns/menubar/menu-and-menubar-pattern.html b/content/patterns/menubar/menu-and-menubar-pattern.html
index 123e8b9637..c8af7ff04c 100644
--- a/content/patterns/menubar/menu-and-menubar-pattern.html
+++ b/content/patterns/menubar/menu-and-menubar-pattern.html
@@ -21,7 +21,7 @@ About This Pattern
A menu is a widget that offers a list of choices to the user, such as a set of actions or functions.
Menu widgets behave like native operating system menus, such as the menus that pull down from the menubars commonly found at the top of many desktop application windows.
- A menu is usually opened, or made visible, by activating a menu button, choosing an item in a menu that opens a sub menu, or by invoking a command, such as Shift + F10 in Windows, that opens a context specific menu.
+ A menu is usually opened, or made visible, by activating a menu button, choosing an item in a menu that opens a sub menu, or by invoking a command, such as Shift + F10 in Windows, that opens a context specific menu.
When a user activates a choice in a menu, the menu usually closes unless the choice opened a submenu.
@@ -61,12 +61,12 @@ Keyboard Interaction
When a menu opens, or when a menubar receives focus, keyboard focus is placed on the first item.
Because menubar and menu elements are composite widgets as described in the practice for
Keyboard Navigation Inside Components,
- Tab and Shift + Tab do not move focus among the items in the menu.
+ Tab and Shift + Tab do not move focus among the items in the menu.
Instead, the keyboard commands described in this section enable users to move focus among the elements in a menubar or menu .
-
- Tab and Shift + Tab:
+ Tab and Shift + Tab:
-
Move focus into a
menubar :
@@ -80,7 +80,7 @@ Keyboard Interaction
- When focus is on a
menuitem in a menu or menubar , move focus out of the menu or menubar , and close all menus and submenus.
-
- Note that Tab and Shift + Tab do not move focus into a
menu .
+ Note that Tab and Shift + Tab do not move focus into a menu .
Unlike a menubar , a menu is not visually persistent, and authors are responsible for ensuring focus moves to an item inside of a menu when the menu opens.
@@ -158,7 +158,7 @@ Note
- A separator in a menu is not focusable or interactive.
-
If a menu is opened or a menubar receives focus as a result of a context action, Escape or Enter may return focus to the invoking context.
- For example, a rich text editor may have a menubar that receives focus when a shortcut key, e.g., alt + F10, is pressed while editing.
+ For example, a rich text editor may have a menubar that receives focus when a shortcut key, e.g., alt + F10, is pressed while editing.
In this case, pressing Escape or activating a command from the menu may return focus to the editor.
-
diff --git a/content/patterns/radio/radio-group-pattern.html b/content/patterns/radio/radio-group-pattern.html
index 8c476bd446..bb451c98e1 100644
--- a/content/patterns/radio/radio-group-pattern.html
+++ b/content/patterns/radio/radio-group-pattern.html
@@ -44,7 +44,7 @@
For Radio Groups Not Contained in a Toolbar
-
- Tab and Shift + Tab: Move focus into and out of the radio group.
+ Tab and Shift + Tab: Move focus into and out of the radio group.
When focus moves into a radio group:
- If a radio button is checked, focus is set on the checked button.
@@ -64,7 +64,7 @@ For Radio Groups Not Contained in a Toolbar
Note
The initial focus behavior described above differs slightly from the behavior provided by some browsers for native HTML radio groups.
- In some browsers, if none of the radio buttons are selected, moving focus into the radio group with Shift+Tab will place focus on the last radio button instead of the first radio button.
+ In some browsers, if none of the radio buttons are selected, moving focus into the radio group with Shift + Tab will place focus on the last radio button instead of the first radio button.
diff --git a/content/patterns/tabs/examples/tabs-actions.html b/content/patterns/tabs/examples/tabs-actions.html
index f2a9613124..a632380a51 100644
--- a/content/patterns/tabs/examples/tabs-actions.html
+++ b/content/patterns/tabs/examples/tabs-actions.html
@@ -281,7 +281,7 @@ Tabs
|
- Shift + Tab |
+ Shift + Tab |
- When focus moves into the
tablist , places focus on the menu button associated with the active tab .
diff --git a/content/patterns/tabs/tabs-pattern.html b/content/patterns/tabs/tabs-pattern.html
index 3b0d405322..c32132b334 100644
--- a/content/patterns/tabs/tabs-pattern.html
+++ b/content/patterns/tabs/tabs-pattern.html
@@ -87,7 +87,7 @@ Keyboard Interaction
End (Optional): Moves focus to the last tab.
Optionally, activates the newly focused tab (See note below).
- - Shift + F10: If the tab has an associated popup menu, opens the menu.
+ - Shift + F10: If the tab has an associated popup menu, opens the menu.
-
Delete (Optional): If deletion is allowed, deletes (closes) the current tab element and its associated tab panel, sets focus on the tab following the tab that was closed, and optionally activates the newly focused tab.
If there is not a tab that followed the tab that was deleted, e.g., the deleted tab was the right-most tab in a left-to-right horizontal tab list, sets focus on and optionally activates the tab that preceded the deleted tab.
diff --git a/content/patterns/toolbar/toolbar-pattern.html b/content/patterns/toolbar/toolbar-pattern.html
index 695d92868e..97b8bd832d 100644
--- a/content/patterns/toolbar/toolbar-pattern.html
+++ b/content/patterns/toolbar/toolbar-pattern.html
@@ -58,7 +58,7 @@
Example
Keyboard Interaction
-
- Tab and Shift + Tab: Move focus into and out of the toolbar.
+ Tab and Shift + Tab: Move focus into and out of the toolbar.
When focus moves into a toolbar:
- If focus is moving into the toolbar for the first time, focus is set on the first control that is not disabled.
diff --git a/content/patterns/treegrid/examples/treegrid-1.html b/content/patterns/treegrid/examples/treegrid-1.html
index 11e3bb813d..7c131508c2 100644
--- a/content/patterns/treegrid/examples/treegrid-1.html
+++ b/content/patterns/treegrid/examples/treegrid-1.html
@@ -235,7 +235,7 @@ Keyboard Support
|
- Shift + Tab
+ Shift + Tab
|
@@ -268,7 +268,7 @@ Keyboard Support
|
- Control + Home
+ Control + Home
|
@@ -279,7 +279,7 @@ Keyboard Support
|
- Control + End
+ Control + End
|
diff --git a/content/patterns/treegrid/treegrid-pattern.html b/content/patterns/treegrid/treegrid-pattern.html
index 0ba629c652..0b438b68e7 100644
--- a/content/patterns/treegrid/treegrid-pattern.html
+++ b/content/patterns/treegrid/treegrid-pattern.html
@@ -159,7 +159,7 @@ Keyboard Interaction
- Control + Home:
+ Control + Home:
-
If focus is on a row, moves focus to the first row.
@@ -172,7 +172,7 @@
Keyboard Interaction
- Control + End:
+ Control + End:
-
If focus is on a row, moves focus to the last row.
@@ -196,20 +196,20 @@
Note
While navigation keys, such as arrow keys, are moving focus from cell to cell, they are not available to do something like operate a combobox or move an editing caret inside of a cell.
If this functionality is needed, see Editing and Navigating Inside a Cell.
- - If navigation functions can dynamically add more rows or columns to the DOM, key events that move focus to the beginning or end of the grid, such as control + End, may move focus to the last row in the DOM rather than the last available row in the back-end data.
+ - If navigation functions can dynamically add more rows or columns to the DOM, key events that move focus to the beginning or end of the grid, such as control + End, may move focus to the last row in the DOM rather than the last available row in the back-end data.
If a treegrid supports selection of cells, rows, or columns, the following keys are commonly used for these functions.
-
- Control + Space:
+ Control + Space:
- If focus is on a row, selects all cells.
- If focus is on a cell, selects the column that contains the focus.
-
- Shift + Space:
+ Shift + Space:
- If focus is on a row, selects the row.
-
@@ -218,30 +218,30 @@
Note
- - Control + A: Selects all cells.
+ - Control + A: Selects all cells.
-
- Shift + Right Arrow:
+ Shift + Right Arrow:
- If focus is on a row, does not change selection.
- if focus is on a cell, extends selection one cell to the right.
-
- Shift + Left Arrow:
+ Shift + Left Arrow:
- If focus is on a row, does not change selection.
- if focus is on a cell, extends selection one cell to the left.
-
- Shift + Down Arrow:
+ Shift + Down Arrow:
- If focus is on a row, extends selection to all the cells in the next row.
- If focus is on a cell, extends selection one cell down.
-
- Shift + Up Arrow:
+ Shift + Up Arrow:
- If focus is on a row, extends selection to all the cells in the previous row.
- If focus is on a cell, extends selection one cell up.
diff --git a/content/patterns/treeview/treeview-pattern.html b/content/patterns/treeview/treeview-pattern.html
index 1e8ee01dd3..8eaff4c7e1 100644
--- a/content/patterns/treeview/treeview-pattern.html
+++ b/content/patterns/treeview/treeview-pattern.html
@@ -127,19 +127,19 @@ Keyboard Interaction
Recommended selection model -- holding a modifier key while moving focus is not necessary:
- Space: Toggles the selection state of the focused node.
- - Shift + Down Arrow (Optional): Moves focus to and toggles the selection state of the next node.
- - Shift + Up Arrow (Optional): Moves focus to and toggles the selection state of the previous node.
- - Shift + Space (Optional): Selects contiguous nodes from the most recently selected node to the current node.
+ - Shift + Down Arrow (Optional): Moves focus to and toggles the selection state of the next node.
+ - Shift + Up Arrow (Optional): Moves focus to and toggles the selection state of the previous node.
+ - Shift + Space (Optional): Selects contiguous nodes from the most recently selected node to the current node.
-
- Control + Shift + Home (Optional): Selects the node with focus and all nodes up to the first node.
+ Control + Shift + Home (Optional): Selects the node with focus and all nodes up to the first node.
Optionally, moves focus to the first node.
-
- Control + Shift + End (Optional): Selects the node with focus and all nodes down to the last node.
+ Control + Shift + End (Optional): Selects the node with focus and all nodes down to the last node.
Optionally, moves focus to the last node.
-
- Control + A (Optional): Selects all nodes in the tree.
+ Control + A (Optional): Selects all nodes in the tree.
Optionally, if all nodes are selected, it can also unselect all nodes.
@@ -147,22 +147,22 @@ Keyboard Interaction
-
Alternative selection model -- Moving focus without holding the Shift or Control modifier unselects all selected nodes except for the focused node:
- - Shift + Down Arrow: Moves focus to and toggles the selection state of the next node.
- - Shift + Up Arrow: Moves focus to and toggles the selection state of the previous node.
- - Control + Down Arrow: Without changing the selection state, moves focus to the next node.
- - Control + Up Arrow: Without changing the selection state, moves focus to the previous node.
- - Control + Space: Toggles the selection state of the focused node.
- - Shift + Space (Optional): Selects contiguous nodes from the most recently selected node to the current node.
+ - Shift + Down Arrow: Moves focus to and toggles the selection state of the next node.
+ - Shift + Up Arrow: Moves focus to and toggles the selection state of the previous node.
+ - Control + Down Arrow: Without changing the selection state, moves focus to the next node.
+ - Control + Up Arrow: Without changing the selection state, moves focus to the previous node.
+ - Control + Space: Toggles the selection state of the focused node.
+ - Shift + Space (Optional): Selects contiguous nodes from the most recently selected node to the current node.
-
- Control + Shift + Home (Optional): Selects the node with focus and all nodes up to the first node.
+ Control + Shift + Home (Optional): Selects the node with focus and all nodes up to the first node.
Optionally, moves focus to the first node.
-
- Control + Shift + End (Optional): Selects the node with focus and all nodes down to the last node.
+ Control + Shift + End (Optional): Selects the node with focus and all nodes down to the last node.
Optionally, moves focus to the last node.
-
- Control + A (Optional): Selects all nodes in the tree.
+ Control + A (Optional): Selects all nodes in the tree.
Optionally, if all nodes are selected, it can also unselect all nodes.
diff --git a/content/practices/keyboard-interface/keyboard-interface-practice.html b/content/practices/keyboard-interface/keyboard-interface-practice.html
index ce83c87e71..429dba46e0 100644
--- a/content/practices/keyboard-interface/keyboard-interface-practice.html
+++ b/content/practices/keyboard-interface/keyboard-interface-practice.html
@@ -27,7 +27,7 @@ Introduction
- Understanding fundamental principles of focus movement conventions used in ARIA design patterns.
- Maintaining visible focus, predictable focus movement, and distinguishing between keyboard focus and the selected state.
- - Managing movement of keyboard focus between components, e.g., how the focus moves when the Tab and Shift+Tab keys are pressed.
+ - Managing movement of keyboard focus between components, e.g., how the focus moves when the Tab and Shift + Tab keys are pressed.
- Managing movement of keyboard focus inside components that contain multiple focusable elements, e.g., two different methods for programmatically exposing focus inside widgets like radio groups, menus, listboxes, trees, and grids.
- Determining when to make disabled interactive elements focusable.
- Assigning and revealing keyboard shortcuts, including guidance on how to avoid problematic conflicts with keyboard commands of assistive technologies, browsers, and operating systems.
@@ -54,7 +54,7 @@ Fundamental Keyboard Navigation Conventions
- A primary keyboard navigation convention common across all platforms is that the tab and shift+tab keys move focus from one UI component to another while other keys, primarily the arrow keys, move focus inside of components that include multiple focusable elements.
+ A primary keyboard navigation convention common across all platforms is that the tab and shift + tab keys move focus from one UI component to another while other keys, primarily the arrow keys, move focus inside of components that include multiple focusable elements.
The path that the focus follows when pressing the tab key is known as the tab sequence or tab ring.
@@ -262,7 +262,7 @@ Keyboard Navigation Inside Components
As described in section Fundamental Keyboard Navigation Conventions, the tab sequence should include only one focusable element of a composite UI component.
- Once a composite contains focus, keys other than Tab and Shift + Tab enable the user to move focus among its focusable elements.
+ Once a composite contains focus, keys other than Tab and Shift + Tab enable the user to move focus among its focusable elements.
Authors are free to choose which keys move focus inside of a composite, but they are strongly advised to use the same key bindings as similar components in common GUI operating systems as demonstrated in APG Patterns.
@@ -314,7 +314,7 @@ Managing Focus Within Components Using a Roving tabindex
-
- If the design calls for a specific element to be focused the next time the user moves focus into the composite with Tab or Shift+Tab, check if that target element has
tabindex="0" when the composite loses focus.
+ If the design calls for a specific element to be focused the next time the user moves focus into the composite with Tab or Shift + Tab, check if that target element has tabindex="0" when the composite loses focus.
If it does not, set tabindex="0" on the target element and set tabindex="-1" on the element that previously had tabindex="0" .
@@ -355,7 +355,7 @@ Managing Focus in Composites Using aria-activedescendant
- If the design calls for a specific element to be focused the next time a user moves focus into the composite with Tab or Shift+Tab, check if aria-activedescendant is referring to that target element when the container loses focus.
+ If the design calls for a specific element to be focused the next time a user moves focus into the composite with Tab or Shift + Tab, check if aria-activedescendant is referring to that target element when the container loses focus.
If it is not, set aria-activedescendant to refer to the target element.
@@ -454,33 +454,33 @@ Key Assignment Conventions for Common Functions
|
open context menu |
- Shift + F10 |
+ Shift + F10 |
|
Copy to clipboard |
- Control + C |
- Command + C |
+ Control + C |
+ Command + C |
Paste from clipboard |
- Control + V |
- Command + V |
+ Control + V |
+ Command + V |
Cut to clipboard |
- Control + X |
- Command + X |
+ Control + X |
+ Command + X |
undo last action |
- Control + Z |
- Command + Z |
+ Control + Z |
+ Command + Z |
Redo action |
- Control + Y |
- Command + Shift + Z |
+ Control + Y |
+ Command + Shift + Z |
@@ -592,7 +592,7 @@ Choose Where to Add Shortcuts
Assigning Keyboard Shortcuts
When choosing the keys to assign to a shortcut, there are many factors to consider.