From 1d66bf52420eaf6f7e4bb1adcfda8261a6999965 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Tue, 5 Aug 2014 16:23:52 -0400 Subject: [PATCH 1/3] All: Normalize keyboard interaction markup --- entries/accordion.xml | 12 ++++++------ entries/autocomplete.xml | 14 +++++++------- entries/datepicker.xml | 26 +++++++++++++------------- entries/menu.xml | 12 ++++++------ entries/selectmenu.xml | 26 +++++++++++++------------- entries/spinner.xml | 8 ++++---- entries/tabs.xml | 22 +++++++++++----------- 7 files changed, 60 insertions(+), 60 deletions(-) diff --git a/entries/accordion.xml b/entries/accordion.xml index 569785cd..00a3c73e 100644 --- a/entries/accordion.xml +++ b/entries/accordion.xml @@ -21,16 +21,16 @@

When focus is on a header, the following key commands are available:

When focus is in a panel:

diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml index 1b225fcf..ed5e93bc 100644 --- a/entries/autocomplete.xml +++ b/entries/autocomplete.xml @@ -15,17 +15,17 @@

When the menu is open, the following key commands are available:

When the menu is closed, the following key commands are available:

diff --git a/entries/datepicker.xml b/entries/datepicker.xml index 9f392858..d29dea4c 100644 --- a/entries/datepicker.xml +++ b/entries/datepicker.xml @@ -10,19 +10,19 @@

Keyboard interaction

While the datepicker is open, the following key commands are available:

    -
  • PAGE UP: Move to the previous month.
    • -
  • PAGE DOWN: Move to the next month.
    • -
  • CTRL + PAGE UP: Move to the previous year.
    • -
  • CTRL + PAGE DOWN: Move to the next year.
    • -
  • CTRL + HOME: Open the datepicker if closed.
    • -
  • CTRL/COMMAND + HOME: Move to the current month.
    • -
  • CTRL/COMMAND + LEFT: Move to the previous day.
    • -
  • CTRL/COMMAND + RIGHT: Move to the next day.
    • -
  • CTRL/COMMAND + UP: Move to the previous week.
    • -
  • CTRL/COMMAND + DOWN: Move the next week.
    • -
  • ENTER: Select the focused date.
    • -
  • CTRL/COMMAND + END: Close the datepicker and erase the date.
    • -
  • ESCAPE: Close the datepicker without selection.
    • +
  • PAGE UP - Move to the previous month.
    • +
  • PAGE DOWN - Move to the next month.
    • +
  • CTRL + PAGE UP - Move to the previous year.
    • +
  • CTRL + PAGE DOWN - Move to the next year.
    • +
  • CTRL + HOME - Open the datepicker if closed.
    • +
  • CTRL/COMMAND + HOME - Move to the current month.
    • +
  • CTRL/COMMAND + LEFT - Move to the previous day.
    • +
  • CTRL/COMMAND + RIGHT - Move to the next day.
    • +
  • CTRL/COMMAND + UP - Move to the previous week.
    • +
  • CTRL/COMMAND + DOWN - Move the next week.
    • +
  • ENTER - Select the focused date.
    • +
  • CTRL/COMMAND + END - Close the datepicker and erase the date.
    • +
  • ESCAPE - Close the datepicker without selection.

Utility functions

diff --git a/entries/menu.xml b/entries/menu.xml index 9a5c2c6b..f1e43fdb 100644 --- a/entries/menu.xml +++ b/entries/menu.xml @@ -55,12 +55,12 @@

Keyboard interaction

    -
  • ENTER/SPACE: Invoke the focused menu item's action, which may be opening a submenu.
    • -
  • UP: Move focus to the previous menu item.
    • -
  • DOWN: Move focus to the next menu item.
    • -
  • RIGHT: Open the submenu, if available.
    • -
  • LEFT: Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.
    • -
  • ESCAPE: Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.
    • +
  • ENTER/SPACE - Invoke the focused menu item's action, which may be opening a submenu.
    • +
  • UP - Move focus to the previous menu item.
    • +
  • DOWN - Move focus to the next menu item.
    • +
  • RIGHT - Open the submenu, if available.
    • +
  • LEFT - Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.
    • +
  • ESCAPE - Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.

Typing a letter moves focus to the first item whose title starts with that character. Repeating the same character cycles through matching items. Typing more characters within the one second timer matches those characters.

diff --git a/entries/selectmenu.xml b/entries/selectmenu.xml index f07acfb9..a9908e5b 100644 --- a/entries/selectmenu.xml +++ b/entries/selectmenu.xml @@ -11,23 +11,23 @@

When the menu is open, the following key commands are available:

    -
  • UP/LEFT: Move focus to the previous item.
    • -
  • DOWN/RIGHT: Move focus to the next item.
    • -
  • END/PAGE DOWN: Move focus to the last item.
    • -
  • HOME/PAGE UP: Move focus to the first item.
    • -
  • ESCAPE: Close the menu.
    • -
  • ENTER/SPACE: Select the currently focused item and close the menu.
    • -
  • ALT+UP/DOWN: Toggle the visibility of the menu.
    • +
  • UP/LEFT - Move focus to the previous item.
    • +
  • DOWN/RIGHT - Move focus to the next item.
    • +
  • END/PAGE DOWN - Move focus to the last item.
    • +
  • HOME/PAGE UP - Move focus to the first item.
    • +
  • ESCAPE - Close the menu.
    • +
  • ENTER/SPACE - Select the currently focused item and close the menu.
    • +
  • ALT + UP/DOWN - Toggle the visibility of the menu.

When the menu is closed, the following key commands are available:

    -
  • UP/LEFT: Select the previous item.
    • -
  • DOWN/RIGHT: Select the next item.
    • -
  • END/PAGE DOWN: Select the last item.
    • -
  • HOME/PAGE UP: Select the first item.
    • -
  • ALT+UP/DOWN: Toggle the visibility of the menu.
    • -
  • SPACE: Open the menu.
    • +
  • UP/LEFT - Select the previous item.
    • +
  • DOWN/RIGHT - Select the next item.
    • +
  • END/PAGE DOWN - Select the last item.
    • +
  • HOME/PAGE UP - Select the first item.
    • +
  • ALT + UP/DOWN - Toggle the visibility of the menu.
    • +
  • SPACE - Open the menu.
diff --git a/entries/spinner.xml b/entries/spinner.xml index 4a6cddb8..9184bbea 100644 --- a/entries/spinner.xml +++ b/entries/spinner.xml @@ -12,10 +12,10 @@

Keyboard interaction

    -
  • UP: Increment the value by one step.
    • -
  • DOWN: Decrement the value by one step.
    • -
  • PAGE UP: Increment the value by one page.
    • -
  • PAGE DOWN: Decrement the value by one page.
    • +
  • UP - Increment the value by one step.
    • +
  • DOWN - Decrement the value by one step.
    • +
  • PAGE UP - Increment the value by one page.
    • +
  • PAGE DOWN - Decrement the value by one page.

Focus stays in the text field, even after using the mouse to click one of the spin buttons.

diff --git a/entries/tabs.xml b/entries/tabs.xml index c261fff8..4992e285 100644 --- a/entries/tabs.xml +++ b/entries/tabs.xml @@ -38,21 +38,21 @@

When focus is on a tab, the following key commands are available:

    -
  • UP/LEFT: Move focus to the previous tab. If on first tab, moves focus to last tab. Activate focused tab after a short delay.
    • -
  • DOWN/RIGHT: Move focus to the next tab. If on last tab, moves focus to first tab. Activate focused tab after a short delay.
    • -
  • HOME: Move focus to the first tab. Activate focused tab after a short delay.
    • -
  • END: Move focus to the last tab. Activate focused tab after a short delay.
    • -
  • SPACE: Activate panel associated with focused tab.
    • -
  • ENTER: Activate or toggle panel associated with focused tab.
    • -
  • ALT+PAGE UP: Move focus to the previous tab and immediately activate.
    • -
  • ALT+PAGE DOWN: Move focus to the next tab and immediately activate.
    • +
  • UP/LEFT - Move focus to the previous tab. If on first tab, moves focus to last tab. Activate focused tab after a short delay.
    • +
  • DOWN/RIGHT - Move focus to the next tab. If on last tab, moves focus to first tab. Activate focused tab after a short delay.
    • +
  • HOME - Move focus to the first tab. Activate focused tab after a short delay.
    • +
  • END - Move focus to the last tab. Activate focused tab after a short delay.
    • +
  • SPACE - Activate panel associated with focused tab.
    • +
  • ENTER - Activate or toggle panel associated with focused tab.
    • +
  • ALT + PAGE UP - Move focus to the previous tab and immediately activate.
    • +
  • ALT + PAGE DOWN - Move focus to the next tab and immediately activate.

When focus is in a panel, the following key commands are available:

    -
  • CTRL+UP: Move focus to associated tab.
    • -
  • ALT+PAGE UP: Move focus to the previous tab and immediately activate.
    • -
  • ALT+PAGE DOWN: Move focus to the next tab and immediately activate.
    • +
  • CTRL + UP - Move focus to associated tab.
    • +
  • ALT + PAGE UP - Move focus to the previous tab and immediately activate.
    • +
  • ALT + PAGE DOWN - Move focus to the next tab and immediately activate.
From 5ab484b9ac1857b5f4132354e7f36a8a6aed4d95 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Wed, 6 Aug 2014 14:27:18 -0400 Subject: [PATCH 2/3] [fixup]: ALT/OPTION --- entries/selectmenu.xml | 4 ++-- entries/tabs.xml | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/entries/selectmenu.xml b/entries/selectmenu.xml index a9908e5b..2ba8e050 100644 --- a/entries/selectmenu.xml +++ b/entries/selectmenu.xml @@ -17,7 +17,7 @@
  • HOME/PAGE UP - Move focus to the first item.
  • ESCAPE - Close the menu.
  • ENTER/SPACE - Select the currently focused item and close the menu.
    • -
  • ALT + UP/DOWN - Toggle the visibility of the menu.
    • +
  • ALT/OPTION + UP/DOWN - Toggle the visibility of the menu.

    • When the menu is closed, the following key commands are available:

    @@ -26,7 +26,7 @@
  • DOWN/RIGHT - Select the next item.
  • END/PAGE DOWN - Select the last item.
  • HOME/PAGE UP - Select the first item.
    • -
  • ALT + UP/DOWN - Toggle the visibility of the menu.
    • +
  • ALT/OPTION + UP/DOWN - Toggle the visibility of the menu.
  • SPACE - Open the menu.
    • diff --git a/entries/tabs.xml b/entries/tabs.xml index 4992e285..8f6f406d 100644 --- a/entries/tabs.xml +++ b/entries/tabs.xml @@ -44,15 +44,15 @@
  • END - Move focus to the last tab. Activate focused tab after a short delay.
  • SPACE - Activate panel associated with focused tab.
  • ENTER - Activate or toggle panel associated with focused tab.
    • -
  • ALT + PAGE UP - Move focus to the previous tab and immediately activate.
    • -
  • ALT + PAGE DOWN - Move focus to the next tab and immediately activate.
    • +
  • ALT/OPTION + PAGE UP - Move focus to the previous tab and immediately activate.
    • +
  • ALT/OPTION + PAGE DOWN - Move focus to the next tab and immediately activate.

    • When focus is in a panel, the following key commands are available:

    • CTRL + UP - Move focus to associated tab.
      • -
    • ALT + PAGE UP - Move focus to the previous tab and immediately activate.
      • -
    • ALT + PAGE DOWN - Move focus to the next tab and immediately activate.
      • +
    • ALT/OPTION + PAGE UP - Move focus to the previous tab and immediately activate.
      • +
    • ALT/OPTION + PAGE DOWN - Move focus to the next tab and immediately activate.
    From ed66524b5b7278afc5a02d41c5b886d3234b6ec0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Scott=20Gonz=C3=A1lez?= Date: Wed, 6 Aug 2014 14:34:25 -0400 Subject: [PATCH 3/3] [fixup]: Switch back to colons --- entries/accordion.xml | 12 ++++++------ entries/autocomplete.xml | 14 +++++++------- entries/datepicker.xml | 26 +++++++++++++------------- entries/menu.xml | 12 ++++++------ entries/selectmenu.xml | 26 +++++++++++++------------- entries/spinner.xml | 8 ++++---- entries/tabs.xml | 22 +++++++++++----------- 7 files changed, 60 insertions(+), 60 deletions(-) diff --git a/entries/accordion.xml b/entries/accordion.xml index 00a3c73e..b4c107eb 100644 --- a/entries/accordion.xml +++ b/entries/accordion.xml @@ -21,16 +21,16 @@

    When focus is on a header, the following key commands are available:

      -
    • UP/LEFT - Move focus to the previous header. If on first header, moves focus to last header.
      • -
    • DOWN/RIGHT - Move focus to the next header. If on last header, moves focus to first header.
      • -
    • HOME - Move focus to the first header.
      • -
    • END - Move focus to the last header.
      • -
    • SPACE/ENTER - Activate panel associated with focused header.
      • +
    • UP/LEFT: Move focus to the previous header. If on first header, moves focus to last header.
      • +
    • DOWN/RIGHT: Move focus to the next header. If on last header, moves focus to first header.
      • +
    • HOME: Move focus to the first header.
      • +
    • END: Move focus to the last header.
      • +
    • SPACE/ENTER: Activate panel associated with focused header.

    When focus is in a panel:

      -
    • CTRL + UP - Move focus to associated header.
      • +
    • CTRL + UP: Move focus to associated header.
    diff --git a/entries/autocomplete.xml b/entries/autocomplete.xml index ed5e93bc..34cdeb84 100644 --- a/entries/autocomplete.xml +++ b/entries/autocomplete.xml @@ -15,17 +15,17 @@

    When the menu is open, the following key commands are available:

      -
    • UP - Move focus to the previous item. If on first item, move focus to the input. If on the input, move focus to last item.
      • -
    • DOWN - Move focus to the next item. If on last item, move focus to the input. If on the input, move focus to the first item.
      • -
    • ESCAPE - Close the menu.
      • -
    • ENTER - Select the currently focused item and close the menu.
      • -
    • TAB - Select the currently focused item, close the menu, and move focus to the next focusable element.
      • -
    • PAGE UP/PAGE DOWN - Scroll through a page of items (based on height of menu). It's generally a bad idea to display so many items that users need to page.
      • +
    • UP: Move focus to the previous item. If on first item, move focus to the input. If on the input, move focus to last item.
      • +
    • DOWN: Move focus to the next item. If on last item, move focus to the input. If on the input, move focus to the first item.
      • +
    • ESCAPE: Close the menu.
      • +
    • ENTER: Select the currently focused item and close the menu.
      • +
    • TAB: Select the currently focused item, close the menu, and move focus to the next focusable element.
      • +
    • PAGE UP/PAGE DOWN: Scroll through a page of items (based on height of menu). It's generally a bad idea to display so many items that users need to page.

    When the menu is closed, the following key commands are available:

      -
    • UP/DOWN - Open the menu, if the minLength has been met.
      • +
    • UP/DOWN: Open the menu, if the minLength has been met.
    diff --git a/entries/datepicker.xml b/entries/datepicker.xml index d29dea4c..9f392858 100644 --- a/entries/datepicker.xml +++ b/entries/datepicker.xml @@ -10,19 +10,19 @@

    Keyboard interaction

    While the datepicker is open, the following key commands are available:

      -
    • PAGE UP - Move to the previous month.
      • -
    • PAGE DOWN - Move to the next month.
      • -
    • CTRL + PAGE UP - Move to the previous year.
      • -
    • CTRL + PAGE DOWN - Move to the next year.
      • -
    • CTRL + HOME - Open the datepicker if closed.
      • -
    • CTRL/COMMAND + HOME - Move to the current month.
      • -
    • CTRL/COMMAND + LEFT - Move to the previous day.
      • -
    • CTRL/COMMAND + RIGHT - Move to the next day.
      • -
    • CTRL/COMMAND + UP - Move to the previous week.
      • -
    • CTRL/COMMAND + DOWN - Move the next week.
      • -
    • ENTER - Select the focused date.
      • -
    • CTRL/COMMAND + END - Close the datepicker and erase the date.
      • -
    • ESCAPE - Close the datepicker without selection.
      • +
    • PAGE UP: Move to the previous month.
      • +
    • PAGE DOWN: Move to the next month.
      • +
    • CTRL + PAGE UP: Move to the previous year.
      • +
    • CTRL + PAGE DOWN: Move to the next year.
      • +
    • CTRL + HOME: Open the datepicker if closed.
      • +
    • CTRL/COMMAND + HOME: Move to the current month.
      • +
    • CTRL/COMMAND + LEFT: Move to the previous day.
      • +
    • CTRL/COMMAND + RIGHT: Move to the next day.
      • +
    • CTRL/COMMAND + UP: Move to the previous week.
      • +
    • CTRL/COMMAND + DOWN: Move the next week.
      • +
    • ENTER: Select the focused date.
      • +
    • CTRL/COMMAND + END: Close the datepicker and erase the date.
      • +
    • ESCAPE: Close the datepicker without selection.

    Utility functions

    diff --git a/entries/menu.xml b/entries/menu.xml index f1e43fdb..24d23bad 100644 --- a/entries/menu.xml +++ b/entries/menu.xml @@ -55,12 +55,12 @@

    Keyboard interaction

      -
    • ENTER/SPACE - Invoke the focused menu item's action, which may be opening a submenu.
      • -
    • UP - Move focus to the previous menu item.
      • -
    • DOWN - Move focus to the next menu item.
      • -
    • RIGHT - Open the submenu, if available.
      • -
    • LEFT - Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.
      • -
    • ESCAPE - Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.
      • +
    • ENTER/SPACE: Invoke the focused menu item's action, which may be opening a submenu.
      • +
    • UP: Move focus to the previous menu item.
      • +
    • DOWN: Move focus to the next menu item.
      • +
    • RIGHT: Open the submenu, if available.
      • +
    • LEFT: Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.
      • +
    • ESCAPE: Close the current submenu and move focus to the parent menu item. If not in a submenu, do nothing.

    Typing a letter moves focus to the first item whose title starts with that character. Repeating the same character cycles through matching items. Typing more characters within the one second timer matches those characters.

    diff --git a/entries/selectmenu.xml b/entries/selectmenu.xml index 2ba8e050..18055590 100644 --- a/entries/selectmenu.xml +++ b/entries/selectmenu.xml @@ -11,23 +11,23 @@

    When the menu is open, the following key commands are available:

      -
    • UP/LEFT - Move focus to the previous item.
      • -
    • DOWN/RIGHT - Move focus to the next item.
      • -
    • END/PAGE DOWN - Move focus to the last item.
      • -
    • HOME/PAGE UP - Move focus to the first item.
      • -
    • ESCAPE - Close the menu.
      • -
    • ENTER/SPACE - Select the currently focused item and close the menu.
      • -
    • ALT/OPTION + UP/DOWN - Toggle the visibility of the menu.
      • +
    • UP/LEFT: Move focus to the previous item.
      • +
    • DOWN/RIGHT: Move focus to the next item.
      • +
    • END/PAGE DOWN: Move focus to the last item.
      • +
    • HOME/PAGE UP: Move focus to the first item.
      • +
    • ESCAPE: Close the menu.
      • +
    • ENTER/SPACE: Select the currently focused item and close the menu.
      • +
    • ALT/OPTION + UP/DOWN: Toggle the visibility of the menu.

    When the menu is closed, the following key commands are available:

      -
    • UP/LEFT - Select the previous item.
      • -
    • DOWN/RIGHT - Select the next item.
      • -
    • END/PAGE DOWN - Select the last item.
      • -
    • HOME/PAGE UP - Select the first item.
      • -
    • ALT/OPTION + UP/DOWN - Toggle the visibility of the menu.
      • -
    • SPACE - Open the menu.
      • +
    • UP/LEFT: Select the previous item.
      • +
    • DOWN/RIGHT: Select the next item.
      • +
    • END/PAGE DOWN: Select the last item.
      • +
    • HOME/PAGE UP: Select the first item.
      • +
    • ALT/OPTION + UP/DOWN: Toggle the visibility of the menu.
      • +
    • SPACE: Open the menu.
    diff --git a/entries/spinner.xml b/entries/spinner.xml index 9184bbea..71ac8504 100644 --- a/entries/spinner.xml +++ b/entries/spinner.xml @@ -12,10 +12,10 @@

    Keyboard interaction

      -
    • UP - Increment the value by one step.
      • -
    • DOWN - Decrement the value by one step.
      • -
    • PAGE UP - Increment the value by one page.
      • -
    • PAGE DOWN - Decrement the value by one page.
      • +
    • UP: Increment the value by one step.
      • +
    • DOWN: Decrement the value by one step.
      • +
    • PAGE UP: Increment the value by one page.
      • +
    • PAGE DOWN: Decrement the value by one page.

    Focus stays in the text field, even after using the mouse to click one of the spin buttons.

    diff --git a/entries/tabs.xml b/entries/tabs.xml index 8f6f406d..2b2772e6 100644 --- a/entries/tabs.xml +++ b/entries/tabs.xml @@ -38,21 +38,21 @@

    When focus is on a tab, the following key commands are available:

      -
    • UP/LEFT - Move focus to the previous tab. If on first tab, moves focus to last tab. Activate focused tab after a short delay.
      • -
    • DOWN/RIGHT - Move focus to the next tab. If on last tab, moves focus to first tab. Activate focused tab after a short delay.
      • -
    • HOME - Move focus to the first tab. Activate focused tab after a short delay.
      • -
    • END - Move focus to the last tab. Activate focused tab after a short delay.
      • -
    • SPACE - Activate panel associated with focused tab.
      • -
    • ENTER - Activate or toggle panel associated with focused tab.
      • -
    • ALT/OPTION + PAGE UP - Move focus to the previous tab and immediately activate.
      • -
    • ALT/OPTION + PAGE DOWN - Move focus to the next tab and immediately activate.
      • +
    • UP/LEFT: Move focus to the previous tab. If on first tab, moves focus to last tab. Activate focused tab after a short delay.
      • +
    • DOWN/RIGHT: Move focus to the next tab. If on last tab, moves focus to first tab. Activate focused tab after a short delay.
      • +
    • HOME: Move focus to the first tab. Activate focused tab after a short delay.
      • +
    • END: Move focus to the last tab. Activate focused tab after a short delay.
      • +
    • SPACE: Activate panel associated with focused tab.
      • +
    • ENTER: Activate or toggle panel associated with focused tab.
      • +
    • ALT/OPTION + PAGE UP: Move focus to the previous tab and immediately activate.
      • +
    • ALT/OPTION + PAGE DOWN: Move focus to the next tab and immediately activate.

    When focus is in a panel, the following key commands are available:

      -
    • CTRL + UP - Move focus to associated tab.
      • -
    • ALT/OPTION + PAGE UP - Move focus to the previous tab and immediately activate.
      • -
    • ALT/OPTION + PAGE DOWN - Move focus to the next tab and immediately activate.
      • +
    • CTRL + UP: Move focus to associated tab.
      • +
    • ALT/OPTION + PAGE UP: Move focus to the previous tab and immediately activate.
      • +
    • ALT/OPTION + PAGE DOWN: Move focus to the next tab and immediately activate.