Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8329336

Scrollbar Keyboard enhancement

XMLWordPrintable

    • Icon: CSR CSR
    • Resolution: Approved
    • Icon: P3 P3
    • jfx23
    • javafx
    • None
    • behavioral
    • minimal
    • Hide
      In theory, there is zero compatibility issue: there is no public API to add a key binding.

      The only way application developers can implement this is via adding an event handler/filter, which may or may not work correctly depending on whether and how the skin is replaced, as described in JDK-8231245).
      Show
      In theory, there is zero compatibility issue: there is no public API to add a key binding. The only way application developers can implement this is via adding an event handler/filter, which may or may not work correctly depending on whether and how the skin is replaced, as described in JDK-8231245 ).
    • Other
    • JDK

      Summary

      Adding alt-ctrl-LEFT/RIGHT/UP/DOWN (option-command-LEFT/RIGHT/UP/DOWN on macOS) key bindings to a number of controls to support accessibility feature of being able to scroll horizontally and vertically using the keyboard.

      Problem

      Some of the controls that have a small width and the content can't be fully visible have horizontal scrollbars in order to accommodate the entire content. It is not possible to scroll horizontally by using the keyboard. The horizontal scrolling is possible only using the mouse. The same applies to vertical scrolling, for example when the cell size exceeds the height of the viewport.

      Solution

      One solution is to add dedicated key bindings to these controls to facilitate scrolling.

      The key bindings:

      alt-ctrl-LEFT (option-command-LEFT on macOS): scrolls the content to the right (equivalent of moving the horizontal scroll bar to the left)

      alt-ctrl-RIGHT (option-command-RIGHT on macOS): scrolls the content to the left (equivalent of moving the horizontal scroll bar to the right)

      alt-ctrl-UP (option-command-UP on macOS): scrolls the content up (equivalent of moving the vertical scroll bar up)

      alt-ctrl-DOWN (option-command-DOWN on macOS): scrolls the content up (equivalent of moving the vertical scroll bar down)

      NOTES:

      1. For controls in right-to-left orientation, the direction is reversed.

      Specification

      This change affects no public API. This CSR describes a change in behavior.

      |Key Combination       |Platform |Condition         |Function                                |
      |----------------------|---------|------------------|----------------------------------------|
      |alt-shortcut-LEFT     |         |                  |horizontal scroll left
      |alt-shortcut-RIGHT    |         |                  |horizontal scroll right
      |alt-shortcut-UP       |         |                  |vertical unit scroll up
      |alt-shortcut-DOWN     |         |                  |vertical unit scroll down

      Affected controls:

      ListView
      TreeView
      TableView
      TreeTableView

            angorya Andy Goryachev
            shadowbug Shadow Bug
            Kevin Rushforth
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: