From 7bd118bb287248c7ab364f846fc87266db1d943d Mon Sep 17 00:00:00 2001
From: Nick Schonning
Date: Tue, 10 Nov 2020 22:41:17 -0500
Subject: [PATCH] chore: Separate kbd cords for multiple key strokes
---
aria-practices-DeletedSectionsArchive.html | 62 +++---
aria-practices.html | 186 +++++++++---------
examples/accordion/accordion.html | 4 +-
.../coding-template/Example-Template.html | 2 +-
.../combobox/combobox-autocomplete-both.html | 4 +-
.../combobox/combobox-autocomplete-list.html | 4 +-
.../combobox/combobox-autocomplete-none.html | 4 +-
examples/combobox/combobox-datepicker.html | 12 +-
examples/combobox/combobox-select-only.html | 4 +-
examples/combobox/grid-combo.html | 2 +-
examples/dialog-modal/alertdialog.html | 6 +-
examples/dialog-modal/datepicker-dialog.html | 6 +-
examples/dialog-modal/dialog.html | 2 +-
.../disclosure/disclosure-navigation.html | 2 +-
examples/feed/feed.html | 4 +-
examples/grid/LayoutGrids.html | 4 +-
examples/grid/dataGrids.html | 6 +-
examples/listbox/listbox-rearrangeable.html | 18 +-
examples/treegrid/treegrid-1.html | 10 +-
19 files changed, 171 insertions(+), 171 deletions(-)
diff --git a/aria-practices-DeletedSectionsArchive.html b/aria-practices-DeletedSectionsArchive.html
index f8ffc66206..22c9afb4d7 100644
--- a/aria-practices-DeletedSectionsArchive.html
+++ b/aria-practices-DeletedSectionsArchive.html
@@ -184,7 +184,7 @@ Auto Complete
Keyboard Interaction
- With focus in an empty text box, press Down Arrow, Up
- Arrow, Alt + Down Arrow, or Alt + Up Arrow to
+ Arrow, Alt + Arrow, or Alt + Up Arrow to
display the entire list of choices. Focus remains in the text box and no
choice is highlighted.
@@ -278,7 +278,7 @@ Keyboard Interaction
Escape closes the drop down and leaves the typed text
displayed in the text box. Need to consider if pressing Escape
again should clear the typed text. The user must press the Down
- arrow or Alt + Down arrow or click the associated icon to
+ arrow or Alt + Down arrow or click the associated icon to
invoke the drop-down list of choices again.
@@ -341,11 +341,11 @@ Keyboard Interaction
- Left Arrow or Right Arrow move the caret within
the edit field.
- - Alt + Up/Down Arrow opens and closes the list.
+ - Alt + Up/Down Arrow opens and closes the list.
- Up Arrow and Down Arrow moves focus up and down
the list. As focus moves inside the dropdown list, the edit field is
updated.
- - Page Up / Page Down selects the next/previous pages item
+
- Page Up / Page Down selects the next/previous pages item
depending on the lists size.
- Escape closes the dropdown list, returns focus to the edit
field, and does not change the current selection.
@@ -536,7 +536,7 @@ Keyboard Interaction
Focus initially is placed on today's date.
-
- Shift + Tab - reverses the direction of the tab order.
+ Shift + Tab - reverses the direction of the tab order.
Once in the widget, a Shift+Tab will take the user to the previous focusable element in the tab order.
-
@@ -547,8 +547,8 @@
Keyboard Interaction
Left Arrow and Right Arrow - advances one day to the next, also in a continuum.
Visually focus is moved from day to day and wraps from row to row in a grid of days and weeks.
- - Control + Page Up - Moves to the same date in the previous year.
- - Control + Page Down - Moves to the same date in the next year.
+ - Control + Page Up - Moves to the same date in the previous year.
+ - Control + Page Down - Moves to the same date in the next year.
-
Space -
@@ -556,7 +556,7 @@ Keyboard Interaction
-
Contiguous Mode: Similar to selecting a range of text.
Space selects the first date.
- Shift + Arrows add to the selection.
+ Shift + Arrows add to the selection.
Pressing Space again deselects the previous selections and selects the current focused date.
@@ -678,9 +678,9 @@ Keyboard Interaction:
- Escape The tooltip dialog is closed by pressing the escape key when focus is within the dialog, mouse clicking on a close icon, or mouse clicking outside of the dialog onto the application.
- Tab Focus must be held within the dialog until it is cancelled or submitted. As the user presses tab to move within items in the dialog, pressing tab with focus on the last focusable item in the dialog will move focus back to the first focusable item in the dialog.
- - Shift + Tab Likewise, if the user is shift-tabbing through elements in the dialog, pressing shift-tab with focus on the first focusable item in the dialog will move focus to the last item in the dialog.
+ - Shift + Tab Likewise, if the user is shift-tabbing through elements in the dialog, pressing shift-tab with focus on the first focusable item in the dialog will move focus to the last item in the dialog.
- It is modal because focus is trapped within the dialog as the user navigates via the Tab and Shift + Tab key.
+ It is modal because focus is trapped within the dialog as the user navigates via the Tab and Shift + Tab key.
Unlike a true modal dialog, the user can click outside of the dialog, however in that case the tooltip dialog is immediately closed.
A tooltip dialog can not be moved/dragged.
Other than the close and move behavior, all other behaviors of a modal dialog are implemented by the tooltip dialog.
@@ -735,7 +735,7 @@ Popup Help (aka Bubble Help)
Keyboard Interaction
- - Control + F1
+
- Control + F1
- Posts the Popup Help widget.
- Input focus is placed on the first interactive element in the Popup Help.
@@ -782,9 +782,9 @@ Keyboard Interaction
- - Shift + Tab
+
- Shift + Tab
- - As with other keyboard conventions described here, the Shift + Tab has the effect of moving the focus up rather than down and follows the same conventions as described for the modal and non-modal Tab key above.
+ - As with other keyboard conventions described here, the Shift + Tab has the effect of moving the focus up rather than down and follows the same conventions as described for the modal and non-modal Tab key above.
- Enter
@@ -832,12 +832,12 @@
Keyboard Interaction
- The edit control is provided by the browser; it provides the keyboard support for navigating, adding, removing and selecting text, so that behavior is not defined by the rich internet application.
- The browser should also provide a keyboard mechanism for navigating into and out of the edit control. Within most browsers the edit control is put into the tab order of the page and can be navigated into, out of, and through using the tab and shift-tab keys like any standard form control.
- A rich text editor widget needs to provide a user interface for interacting with the browser provided edit control. Interaction between the user interface and editor is defined here assuming that a toolbar is used.
- - Tab and Shift + Tab - If not provided by the browser, the rich text editor widget provides a keyboard mechanism to move into and out of the edit control. Tab and shift-tab are the recommended keystrokes. The toolbar or other user interface component associated with the editor is placed in the tab order immediately before the editor. To set an attribute on text within the edit control the user sets focus into the edit control, moves the insertion point, selects text and presses shift-tab to move focus from the editor back to the toolbar. The user navigates through the toolbar (see toolbar behavior) to a desired attribute and invokes that attribute. When an attribute is invoked, that attribute is applied to the selected text in the editor and focus moves back into the editor at the previous insertion point with the selection intact.
+ - Tab and Shift + Tab - If not provided by the browser, the rich text editor widget provides a keyboard mechanism to move into and out of the edit control. Tab and shift-tab are the recommended keystrokes. The toolbar or other user interface component associated with the editor is placed in the tab order immediately before the editor. To set an attribute on text within the edit control the user sets focus into the edit control, moves the insertion point, selects text and presses shift-tab to move focus from the editor back to the toolbar. The user navigates through the toolbar (see toolbar behavior) to a desired attribute and invokes that attribute. When an attribute is invoked, that attribute is applied to the selected text in the editor and focus moves back into the editor at the previous insertion point with the selection intact.
- Options:
- - Rather than using Shift + Tab to move focus from within the editor to the toolbar, another key combination could be used (Alt + Up Arrow, Control + Shift + Letter, etc.). This would eliminate the need to put the user interface control (in this example a toolbar) into the tab order immediately before the editor component. However, there are drawbacks to using a different keystroke to navigate to the user interface:
+
- Rather than using Shift + Tab to move focus from within the editor to the toolbar, another key combination could be used (Alt + Up Arrow, Control + Shift + Letter, etc.). This would eliminate the need to put the user interface control (in this example a toolbar) into the tab order immediately before the editor component. However, there are drawbacks to using a different keystroke to navigate to the user interface:
- - It is not as "discoverable" as relying on the standard Tab/Shift + Tab behavior;
+ - It is not as "discoverable" as relying on the standard Tab/Shift + Tab behavior;
- It is difficult to find key combinations which are not already captured by the browser or assistive technology.
- Focus could stay within the toolbar after the user invokes an attribute. The user would then have to press an additional key to move focus back into the editor. This would allow multiple attributes to be set on the current selection without having to return back to the user interface but it would add an extra key sequence after setting just a single attribute. Requiring a keystroke to move focus back into the editor would also require modifying the toolbar behavior to intercept this keystroke and to know how to set focus back to the component (the editor) that the toolbar is associated with.
@@ -848,8 +848,8 @@ Keyboard Interaction
Optionally, if the developer wishes to provide the ability to insert a tab into the document, it is recommended one of the following methods be used.
- - Provide indent and outdent buttons in the menu. Keyboard shortcuts to the buttons should be Control + M for indent and Control + Shift + M for outdent.
- - Provide a button in the menu to toggle the use of Tab between the two modes. If this button is used, then Control + M is recommended as a keyboard shortcut to toggle the button.
+ - Provide indent and outdent buttons in the menu. Keyboard shortcuts to the buttons should be Control + M for indent and Control + Shift + M for outdent.
+ - Provide a button in the menu to toggle the use of Tab between the two modes. If this button is used, then Control + M is recommended as a keyboard shortcut to toggle the button.
@@ -1075,20 +1075,20 @@ Keyboard Interaction
- The initial tab enters the grid with focus on the first cell of the first row, often a header.
- Once in the grid a second tab moves out of the grid to the next tab stop.
- - Once focus is established in the grid, a Tab into or a Shift + Tab into the grid will return to the cell which last had focus.
+ - Once focus is established in the grid, a Tab into or a Shift + Tab into the grid will return to the cell which last had focus.
- Left Arrow and Right Arrow keys navigate between columns. If the next cell in the row is empty, focus should not move.
- Up Arrow and Down Arrow The down arrow moves focus to the first column of a child row, if expanded. Otherwise focus is moved to the same column in the next row. Up arrow performs the same navigation but in reverse.
- - Control + Left and Control + Right Arrows expand or collapse rows.
+ - Control + Left and Control + Right Arrows expand or collapse rows.
- If the cell contains an editable field, the Enter key starts edit mode and the Escape key exits edit mode.
- Selecting Cells
- - Control + Space selects the current column.
- - Shift + Space selects the current row.
- - Control + A selects the entire grid.
- - Shift + Arrow selects contiguous cells.
- - Shift + F8 Allows additional cells to be added to a previous selection to accomplish non-contiguous selection.
+ - Control + Space selects the current column.
+ - Shift + Space selects the current row.
+ - Control + A selects the entire grid.
+ - Shift + Arrow selects contiguous cells.
+ - Shift + F8 Allows additional cells to be added to a previous selection to accomplish non-contiguous selection.
See Global Recommendations for information on cut, copy and paste.
@@ -1107,7 +1107,7 @@ Keyboard Interaction
- Enter pressed while focus is on an actionable item will enter Actionable Mode. Focus will remain on the actionable item that has focus.
- Optionally, alphanumeric keys pressed while focus is on an actionable item will enter Actionable Mode. Focus will remain on the actionable item that has focus.
- Tab will move to the next actionable (tabbable) item in the grid and stay within the grid wrapping at the bottom. In this mode each tabbable object in each cell of the grid can be reached with the tab key. If multiple tabbable items are located inside a single grid cell, the tab will stop at each one. When the last tabbable item in a cell is reached the next tab will move to the next tabbable item in the grid, wrapping at the last tabbable item in the grid.
- - Shift + Tab moves to the previous actionable (tabbable) item in the grid and stays within the grid, wrapping at the top.
+ - Shift + Tab moves to the previous actionable (tabbable) item in the grid and stays within the grid, wrapping at the top.
- Escape exits Actionable mode (by which the user may enter text or perform an action to complete a operation) and returns to Navigation Mode (where the user is allowed to move focus among elements). If a widget is in the current grid cell that also uses the Escape key, then it should cancel the event propagation. A subsequent press of the Escape key will return focus to the parent widget.
@@ -1154,11 +1154,11 @@ Keyboard Interaction
- Method 3: Hot Keys
- - Control + Alt + N next, finish
- - Control + Alt + P previous
+ - Control + Alt + N next, finish
+ - Control + Alt + P previous
- Escape cancel, exit without saving
- - Control + Alt + R reset current page to default settings
- - Control + Alt + S save and exit
+ - Control + Alt + R reset current page to default settings
+ - Control + Alt + S save and exit
- Method 4: Like a Dialog
@@ -1887,7 +1887,7 @@ Managing Focus in Dialogs
-
- If the keypress is a Shift + Tab key and the target == the first tab navigable object, then set focus to the last tab-navigable object and stop the key press event. If there is only a single tab focusable item, then focus does not have to be set, but the key press event must be stopped.
+ If the keypress is a Shift + Tab key and the target == the first tab navigable object, then set focus to the last tab-navigable object and stop the key press event. If there is only a single tab focusable item, then focus does not have to be set, but the key press event must be stopped.
-
If the keypress is a Tab key and the target == the last tab navigable object, then set focus to the first tab-navigable object and stop the keypress event. If there is only a single tab-focusable item, then focus does not have to be set but the keypress event must be stopped.
diff --git a/aria-practices.html b/aria-practices.html
index eabca70211..2d9f34ae17 100644
--- a/aria-practices.html
+++ b/aria-practices.html
@@ -203,7 +203,7 @@
Keyboard Interaction
- Tab: Moves focus to the next focusable element; all focusable elements in the accordion are included in the page Tab sequence.
- - Shift + Tab: Moves focus to the previous focusable element; all focusable elements in the accordion are included in the page Tab sequence.
+ - Shift + Tab: Moves focus to the previous focusable element; all focusable elements in the accordion are included in the page Tab sequence.
-
Down Arrow (Optional): If focus is on an accordion header, moves focus to the next accordion header.
If focus is on the last accordion header, either does nothing or moves focus to the first accordion header.
@@ -454,7 +454,7 @@
Keyboard Interaction
If the button is activated with a shortcut key, the focus usually remains in
the context from which the shortcut key was activated. For example, if Alt
+ U were assigned to an "Up" button that moves the currently focused
- item in a list one position higher in the list, pressing Alt + U when the
+ item in a list one position higher in the list, pressing Alt + U when the
focus is in the list would not move the focus from the list.
@@ -539,7 +539,7 @@ Keyboard Interaction
If the carousel has an auto-rotate feature, automatic slide rotation stops when any element in the carousel receives keyboard focus.
It does not resume unless the user activates the rotation control.
- Tab and Shift + Tab: Move focus through the interactive elements of the carousel as specified by the page tab sequence -- scripting for Tab is not necessary.
+ Tab and Shift + Tab: Move focus through the interactive elements of the carousel as specified by the page tab sequence -- scripting for Tab is not necessary.
Button elements implement the keyboard interaction defined in the button pattern.
Note: Activating the rotation control, next slide, and previous slide do not move focus, so users may easily repetitively activate them as many times as desired.
@@ -828,8 +828,8 @@ Combobox Keyboard Interaction
If the combobox is editable, it supports standard single line text editing keys appropriate for the device platform (see note below).
- Alt + Down Arrow (Optional): If the popup is available but not displayed, displays the popup without moving focus.
- Alt + Up Arrow (Optional): If the popup is displayed:
+ Alt + Down Arrow (Optional): If the popup is available but not displayed, displays the popup without moving focus.
+ Alt + Up Arrow (Optional): If the popup is displayed:
- If the popup contains focus, returns focus to the combobox.
- Closes the popup.
@@ -921,8 +921,8 @@ Grid Popup Keyboard Interaction
- If the combobox is editable, returns focus to the combobox and places the cursor after the last character.
- Control + Home (optional): moves focus to the first row.
- Control + End (Optional): moves focus to the last row.
+ Control + Home (optional): moves focus to the first row.
+ Control + End (Optional): moves focus to the last row.
Any printable character: If the combobox is editable, returns the focus to the combobox without closing the popup and types the character.
Backspace (Optional): If the combobox is editable, returns focus to the combobox and deletes the character prior to the cursor.
Delete (Optional): If the combobox is editable, returns focus to the combobox, removes the selected state if a suggestion was selected, and removes the inline autocomplete string if present.
@@ -1091,7 +1091,7 @@ Dialog (Modal)
Like non-modal dialogs, modal dialogs contain their tab sequence.
- That is, Tab and Shift + Tab do not move focus outside the dialog.
+ That is, Tab and Shift + Tab do not move focus outside the dialog.
However, unlike most non-modal dialogs, modal dialogs do not provide means for moving keyboard focus outside the dialog window without closing the dialog.
@@ -1119,7 +1119,7 @@
Keyboard Interaction
If focus is on the last tabbable element inside the dialog, moves focus to the first tabbable element inside the dialog.
- Shift + Tab:
+ Shift + Tab:
- Moves focus to the previous tabbable element inside the dialog.
- If focus is on the first tabbable element inside the dialog, moves focus to the last tabbable element inside the dialog.
@@ -1323,8 +1323,8 @@ Keyboard Interaction
- Page Down: Move focus to next article.
- Page Up: Move focus to previous article.
- - Control + End: Move focus to the first focusable element after the feed.
- - Control + Home: Move focus to the first focusable element before the feed.
+ - Control + End: Move focus to the first focusable element after the feed.
+ - Control + Home: Move focus to the first focusable element before the feed.
- Due to the lack of convention, providing easily discoverable keyboard interface documentation is especially important.
@@ -1338,8 +1338,8 @@ Keyboard Interaction
Users move focus into the nested feed from the content of the containing article with Tab.
This may be slow if the article contains a significant number of links, buttons, or other widgets.
- Provide a key for moving focus from the elements in the containing article to the first item in the nested feed, e.g., Alt + Page Down.
- To continue reading the outer feed, Control + End moves focus to the next article in the outer feed.
+ Provide a key for moving focus from the elements in the containing article to the first item in the nested feed, e.g., Alt + Page Down.
+ To continue reading the outer feed, Control + End moves focus to the next article in the outer feed.
In the rare circumstance that a feed article contains a widget that uses the above suggested keys, the feed navigation key will operate the contained widget, and the user needs to move focus to an element that does not utilize the feed navigation keys in order to navigate the feed.
@@ -1466,8 +1466,8 @@ Keyboard Interaction For Data Grids
Page Up: Moves focus up an author-determined number of rows, typically scrolling so the top row in the currently visible set of rows becomes one of the last visible rows. If focus is in the first row of the grid, focus does not move.
Home: moves focus to the first cell in the row that contains focus.
End: moves focus to the last cell in the row that contains focus.
- Control + Home: moves focus to the first cell in the first row.
- Control + End: moves focus to the last cell in the last row.
+ Control + Home: moves focus to the first cell in the first row.
+ Control + End: moves focus to the last cell in the last row.
-
@@ -1478,17 +1478,17 @@
Keyboard Interaction For Data Grids
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 grid supports selection of cells, rows, or columns, the following keys are commonly used for these functions.
- - Control + Space: selects the column that contains the focus.
- - Shift + Space: Selects the row that contains the focus. If the grid includes a column with checkboxes for selecting rows, this key can serve as a shortcut for checking the box when focus is not on the checkbox.
- - Control + A: Selects all cells.
- - Shift + Right Arrow: Extends selection one cell to the right.
- - Shift + Left Arrow: Extends selection one cell to the left.
- - Shift + Down Arrow: Extends selection one cell down.
- - Shift + Up Arrow: Extends selection one cell Up.
+ - Control + Space: selects the column that contains the focus.
+ - Shift + Space: Selects the row that contains the focus. If the grid includes a column with checkboxes for selecting rows, this key can serve as a shortcut for checking the box when focus is not on the checkbox.
+ - Control + A: Selects all cells.
+ - Shift + Right Arrow: Extends selection one cell to the right.
+ - Shift + Left Arrow: Extends selection one cell to the left.
+ - Shift + Down Arrow: Extends selection one cell down.
+ - Shift + Up Arrow: Extends selection one cell Up.
See for cut, copy, and paste key assignments.
@@ -1559,8 +1559,8 @@ Keyboard Interaction For Layout Grids
End: moves focus to the last cell in the row that contains focus.
Optionally, if the grid has a single column or fewer than three cells per row, focus may instead move to the last cell in the grid.
- Control + Home (optional): moves focus to the first cell in the first row.
- Control + End (Optional): moves focus to the last cell in the last row.
+ Control + Home (optional): moves focus to the first cell in the first row.
+ Control + End (Optional): moves focus to the last cell in the last row.
-
@@ -1571,22 +1571,22 @@
Keyboard Interaction For Layout Grids
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.
It would be unusual for a layout grid to provide functions that require cell selection. If it did, though, the following keys are commonly used for these functions.
- - Control + Space: selects the column that contains the focus.
+ - Control + Space: selects the column that contains the focus.
-
- Shift + Space: Selects the row that contains the focus.
+ Shift + Space: Selects the row that contains the focus.
If the grid includes a column with checkboxes for selecting rows, this key can serve as a shortcut for checking the box when focus is not on the checkbox.
- - Control + A: Selects all cells.
- - Shift + Right Arrow: Extends selection one cell to the right.
- - Shift + Left Arrow: Extends selection one cell to the left.
- - Shift + Down Arrow: Extends selection one cell down.
- - Shift + Up Arrow: Extends selection one cell Up.
+ - Control + A: Selects all cells.
+ - Shift + Right Arrow: Extends selection one cell to the right.
+ - Shift + Left Arrow: Extends selection one cell to the left.
+ - Shift + Down Arrow: Extends selection one cell down.
+ - Shift + Up Arrow: Extends selection one cell Up.
See for cut, copy, and paste key assignments.
@@ -1679,7 +1679,7 @@ Editing and Navigating Inside a Cell
Optionally, the focus movement may wrap inside a single cell or within the grid itself.
- Shift + Tab: moves focus to the previous widget in the grid.
+ Shift + Tab: moves focus to the previous widget in the grid.
Optionally, the focus movement may wrap inside a single cell or within the grid itself.
@@ -1761,7 +1761,7 @@ Examples
Keyboard Interaction
- Enter: Executes the link and moves focus to the link target.
- - Shift + F10 (Optional): Opens a context menu for the link.
+ - Shift + F10 (Optional): Opens a context menu for the link.
@@ -1846,25 +1846,25 @@ 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.
- - 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. Optionally, moves focus to the last option.
- - Control + A (Optional): Selects all options in the list. Optionally, if all options are selected, it may also unselect all options.
+ - 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. Optionally, moves focus to the first 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. Optionally, if all options are selected, it may also unselect all options.
Alternative selection model -- moving focus without holding a Shift or Control modifier unselects all selected nodes except the focused node:
- - 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. Optionally, moves focus to the first 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. Optionally, if all options are selected, it may also unselect all options.
+ - 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. Optionally, moves focus to the first 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. Optionally, if all options are selected, it may also unselect all options.
@@ -1922,7 +1922,7 @@ Menu or Menu bar
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.
@@ -2027,14 +2027,14 @@ Keyboard Interaction
Any key that corresponds to a printable character (Optional): Move focus to the next item in the current menu whose label begins with that printable character.
Escape: Close the menu that contains focus and return focus to the element or context, e.g., menu button or parent menuitem
, from which the menu was opened.
Tab: Moves focus to the next element in the tab sequence, and if the item that had focus is not in a menubar
, closes its menu
and all open parent menu
containers.
- Shift + Tab: Moves focus to the previous element in the tab sequence, and if the item that had focus is not in a menubar
, closes its menu
and all open parent menu
containers.
+ Shift + Tab: Moves focus to the previous element in the tab sequence, and if the item that had focus is not in a menubar
, closes its menu
and all open parent menu
containers.
- Disabled menu items are focusable but cannot be activated.
- 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.
-
@@ -2231,7 +2231,7 @@
For Radio Groups Not Contained in a Toolbar
-
- Tab and Shift + Tab:
+ Tab and Shift + Tab:
Move focus into and out of the radio group.
When focus moves into a radio group :
@@ -2668,7 +2668,7 @@ Keyboard Interaction
- Space or Enter: Activates the tab if it was not activated automatically on focus.
- Home (Optional): Moves focus to the first tab. Optionally, activates the newly focused tab (See note below).
- 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,
@@ -2750,7 +2750,7 @@
Example
Keyboard Interaction
- - Tab and Shift + Tab: Move focus into and out of the toolbar. When focus moves into a 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.
- If the toolbar has previously contained focus, focus is optionally set on the control that last had focus. Otherwise, it is set on the first control that is not disabled.
@@ -2944,25 +2944,25 @@ 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.
- - 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. Optionally, moves focus to the last node.
- - Control + A (Optional): Selects all nodes in the tree. Optionally, if all nodes are selected, it can also unselect all nodes.
+ - 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. Optionally, moves focus to the first 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. Optionally, if all nodes are selected, it can also unselect all nodes.
- 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.
- - 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. Optionally, moves focus to the last node.
- - Control + A (Optional): Selects all nodes in the tree. Optionally, if all nodes are selected, it can also unselect all nodes.
+ - 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. Optionally, moves focus to the first 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. Optionally, if all nodes are selected, it can also unselect all nodes.
@@ -3134,14 +3134,14 @@ Keyboard Interaction
-
- Control + Home:
+ Control + Home:
- If focus is on a row, moves focus to the first row. If focus is in the first row, focus does not move.
- If focus is on a cell, moves focus to the first cell in the column. If focus is in the first row, focus does not move.
-
- Control + End:
+ Control + End:
- If focus is on a row, moves focus to the last row. If focus is in the last row, focus does not move.
- If focus is on a cell, moves focus to the last cell in the column. If focus is in the last row, focus does not move.
@@ -3157,48 +3157,48 @@ Keyboard Interaction
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.
- If focus is on a cell, selects the row that contains the focus. If the treegrid includes a column with checkboxes for selecting rows, this key can serve as a shortcut for checking the box when focus is not on the checkbox.
- - 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.
@@ -5535,7 +5535,7 @@ Keyboard Navigation Inside Components
As described in section , 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 .
@@ -5719,32 +5719,32 @@ 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 |
+ Control + Y |
Command + Shift + Z |
@@ -5844,7 +5844,7 @@ Choose Where to Add Shortcuts
Assigning Keyboard Shortcuts
When choosing the keys to assign to a shortcut, there are many factors to consider.
- - Making the shortcut easy to learn and remember by using a mnemonic (e.g., Control + S for "Save") or following a logical or spacial pattern.
+ - Making the shortcut easy to learn and remember by using a mnemonic (e.g., Control + S for "Save") or following a logical or spacial pattern.
- Localizing the interface, including for differences in which keys are available and how they behave and for language considerations that could impact mnemonics.
- Avoiding and managing conflicts with key assignments used by an assistive technology, the browser, or the operating system.
diff --git a/examples/accordion/accordion.html b/examples/accordion/accordion.html
index 7dfbc7ebdc..34d7b8c272 100644
--- a/examples/accordion/accordion.html
+++ b/examples/accordion/accordion.html
@@ -213,7 +213,7 @@ Keyboard Support
- Shift + Tab |
+ Shift + Tab |
- Moves focus to the previous focusable element.
@@ -273,7 +273,7 @@ Role, Property, State, and Tabindex Attributes
- Element that serves as an accordion header.
- Each accordion header element contains a button that controls the visibility of its content panel.
- - The example uses heading level 3 so it fits correctly within the outline of the page; the example is contained in a section titled with a level 2 heading.
+ - The example uses heading level 3 so it fits correctly within the outline of the page; the example is contained in a section titled with a level 2 heading.
|
diff --git a/examples/coding-template/Example-Template.html b/examples/coding-template/Example-Template.html
index 591c433a58..2b25da3b58 100644
--- a/examples/coding-template/Example-Template.html
+++ b/examples/coding-template/Example-Template.html
@@ -112,7 +112,7 @@ Keyboard Support
Use kbd tags,e.g. KeyName.
Key names use first-letter caps, e.g., Enter.
Single space between multiple Words, e.g., Up Arrow.
- Use + to separate modifiers, e.g., Control + Right Arrow.
+ Use + to separate modifiers, e.g., Control + Right Arrow.
One key per row, e.g., do not combine Up Arrow and Down Arrow into a single row.
Do not use the word "key", e.g., do not write Enter Key or Enter key.
-->
diff --git a/examples/combobox/combobox-autocomplete-both.html b/examples/combobox/combobox-autocomplete-both.html
index 6fe6b5fb88..0fff1bf930 100644
--- a/examples/combobox/combobox-autocomplete-both.html
+++ b/examples/combobox/combobox-autocomplete-both.html
@@ -155,7 +155,7 @@ Textbox
- Alt + Down Arrow |
+ Alt + Down Arrow |
Opens the listbox without moving focus or changing selection.
|
@@ -192,7 +192,7 @@ Textbox
Standard single line text editing keys |
- - Keys used for cursor movement and text manipulation, such as Delete and Shift + Right Arrow.
+ - Keys used for cursor movement and text manipulation, such as Delete and Shift + Right Arrow.
- An HTML
input with type="text" is used for the textbox so the browser will provide platform-specific editing keys.
|
diff --git a/examples/combobox/combobox-autocomplete-list.html b/examples/combobox/combobox-autocomplete-list.html
index 2371e3ad8d..3f1b9a6d14 100644
--- a/examples/combobox/combobox-autocomplete-list.html
+++ b/examples/combobox/combobox-autocomplete-list.html
@@ -156,7 +156,7 @@ Textbox
- Alt + Down Arrow |
+ Alt + Down Arrow |
Opens the listbox without moving focus or changing selection.
|
@@ -188,7 +188,7 @@ Textbox
Standard single line text editing keys |
- - Keys used for cursor movement and text manipulation, such as Delete and Shift + Right Arrow.
+ - Keys used for cursor movement and text manipulation, such as Delete and Shift + Right Arrow.
- An HTML
input with type="text" is used for the textbox so the browser will provide platform-specific editing keys.
|
diff --git a/examples/combobox/combobox-autocomplete-none.html b/examples/combobox/combobox-autocomplete-none.html
index d20457f589..c937798b1f 100644
--- a/examples/combobox/combobox-autocomplete-none.html
+++ b/examples/combobox/combobox-autocomplete-none.html
@@ -110,7 +110,7 @@ Textbox
- Alt + Down Arrow |
+ Alt + Down Arrow |
Opens the listbox without moving focus or changing selection.
|
@@ -137,7 +137,7 @@ Textbox
Standard single line text editing keys |
- - Keys used for cursor movement and text manipulation, such as Delete and Shift + Right Arrow.
+ - Keys used for cursor movement and text manipulation, such as Delete and Shift + Right Arrow.
- An HTML
input with type="text" is used for the textbox so the browser will provide platform-specific editing keys.
|
diff --git a/examples/combobox/combobox-datepicker.html b/examples/combobox/combobox-datepicker.html
index 952bbbfd6d..daa48c8068 100644
--- a/examples/combobox/combobox-datepicker.html
+++ b/examples/combobox/combobox-datepicker.html
@@ -29,7 +29,7 @@
Date Picker Combobox Example
The below date picker demonstrates an implementation of the combobox design pattern that opens a dialog.
- The date picker dialog is opened by activating the choose date button or by moving keyboard focus to the combobox and pressing Down Arrow or Alt + Down Arrow.
+ The date picker dialog is opened by activating the choose date button or by moving keyboard focus to the combobox and pressing Down Arrow or Alt + Down Arrow.
The dialog contains an implementation of the grid pattern for displaying a calendar and enabling selection of a date.
Additional buttons in the dialog are available for changing the month and year shown in the grid.
@@ -42,7 +42,7 @@ Date Picker Combobox Example
- Editable Combobox Without Autocomplete: An editable combobox that demonstrates the behavior associated with
aria-autocomplete=none
.
- Editable Combobox with Grid Popup: An editable combobox that presents suggestions in a grid, enabling users to navigate descriptive information about each suggestion.
-
+
- Shift + Tab |
+ Shift + Tab |
- Moves focus to previous element in the dialog Tab sequence.
@@ -360,7 +360,7 @@ Date Picker Dialog: Date Grid
|
- Shift + Page Up |
+ Shift + Page Up |
- Changes the grid of dates to the previous Year.
@@ -378,7 +378,7 @@ Date Picker Dialog: Date Grid
|
- Shift + Page Down |
+ Shift + Page Down |
- Changes the grid of dates to the next Year.
diff --git a/examples/dialog-modal/dialog.html b/examples/dialog-modal/dialog.html
index e6847a5f81..6e2d7bdc57 100644
--- a/examples/dialog-modal/dialog.html
+++ b/examples/dialog-modal/dialog.html
@@ -257,7 +257,7 @@ Keyboard Support
|
- Shift + Tab |
+ Shift + Tab |
- Moves focus to previous focusable element inside the dialog.
diff --git a/examples/disclosure/disclosure-navigation.html b/examples/disclosure/disclosure-navigation.html
index d8406a6918..5d417bd12a 100644
--- a/examples/disclosure/disclosure-navigation.html
+++ b/examples/disclosure/disclosure-navigation.html
@@ -179,7 +179,7 @@ Keyboard Support
Tab
- Shift + Tab
+ Shift + Tab
|
Move keyboard focus among top-level buttons, and if a dropdown is open, into and through links in the dropdown. |
diff --git a/examples/feed/feed.html b/examples/feed/feed.html
index b45ba520c6..f9a671006a 100644
--- a/examples/feed/feed.html
+++ b/examples/feed/feed.html
@@ -70,11 +70,11 @@ Keyboard Support
Move focus to previous article. |
|
- Control + End |
+ Control + End |
Move focus to the first focusable element after the feed. |
- Control + Home |
+ Control + Home |
Move focus to the first focusable element before the feed. |
diff --git a/examples/grid/LayoutGrids.html b/examples/grid/LayoutGrids.html
index ea40024b5f..ace7cabb81 100644
--- a/examples/grid/LayoutGrids.html
+++ b/examples/grid/LayoutGrids.html
@@ -554,13 +554,13 @@ Keyboard Support
- Control + Home
+ Control + Home
|
Moves focus to the first cell in the first row. |
- Control + End
+ Control + End
|
Moves focus to the last cell in the last row. |
diff --git a/examples/grid/dataGrids.html b/examples/grid/dataGrids.html
index dc6c581f24..24ab37ba6d 100644
--- a/examples/grid/dataGrids.html
+++ b/examples/grid/dataGrids.html
@@ -120,7 +120,7 @@ Notes
-
Data cells can be focused using standard navigation keys, including directional arrows, Home,
- End, Control + Home, and Control + End.
+ End, Control + Home, and Control + End.
-
The Page Down and Page Up keys are not supported since such
@@ -613,13 +613,13 @@
Keyboard Support
- Control + Home
+ Control + Home
|
moves focus to the first cell in the first row. |
- Control + End
+ Control + End
|
moves focus to the last cell in the last row. |
diff --git a/examples/listbox/listbox-rearrangeable.html b/examples/listbox/listbox-rearrangeable.html
index 24cbf65a72..1994767647 100644
--- a/examples/listbox/listbox-rearrangeable.html
+++ b/examples/listbox/listbox-rearrangeable.html
@@ -181,8 +181,8 @@ Accessibility Features
- Action buttons have the following shortcuts:
- - "Up": Alt + Up Arrow
- - "Down": Alt + Down Arrow
+ - "Up": Alt + Up Arrow
+ - "Down": Alt + Down Arrow
- "Add": Enter
- "Not Important", "Important", and "Remove": Delete
@@ -194,7 +194,7 @@ Accessibility Features
-
Using a shortcut key intentionally places focus to optimize both screen reader and keyboard usability.
- For example, pressing Alt + Up Arrow in the "Important Features" list keeps focus on the option that is moved up,
+ For example, pressing Alt + Up Arrow in the "Important Features" list keeps focus on the option that is moved up,
enabling all keyboard users to easily perform consecutive move operations for an option
and screen reader users to hear the position of an option after it is moved.
Similarly, pressing Enter in the available options list leaves focus in the available options list.
@@ -274,25 +274,25 @@
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)
- Command-A (macOS)
+ Control + A (All Platforms)
+ Command + A (macOS)
|
selects all options in the list. If all options are selected, unselects all options. |
diff --git a/examples/treegrid/treegrid-1.html b/examples/treegrid/treegrid-1.html
index ebe8615d70..d836489a34 100644
--- a/examples/treegrid/treegrid-1.html
+++ b/examples/treegrid/treegrid-1.html
@@ -78,7 +78,7 @@
Treegrid Email Inbox Example
NOTE: This example is new in APG 1.1 release 2.
- Please provide feedback in
+ Please provide feedback in
issue 790.
@@ -203,7 +203,7 @@
Keyboard Support
NOTE: The following table includes descriptions of how keyboard commands move focus among cells and rows in the treegrid implementation on this page.
In the example on this page, some cells contain a single focusable widget, and if a cell contains a widget, the cell is not focusable; the widget receives focus instead of the cell.
- So, when a keyboard command description says a command moves focus to a cell, the command may either focus the cell or a widget inside the cell.
+ So, when a keyboard command description says a command moves focus to a cell, the command may either focus the cell or a widget inside the cell.
@@ -274,7 +274,7 @@ Keyboard Support
- Shift + Tab
+ Shift + Tab
|
@@ -307,7 +307,7 @@ Keyboard Support
|
- Control + Home
+ Control + Home
|
@@ -318,7 +318,7 @@ Keyboard Support
|
- Control + End
+ Control + End
|
|