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

Make keyboard navigation more usable in API docs

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P3 P3
    • 25
    • 9
    • tools
    • None
    • master
    • generic
    • generic

      JavaDoc-generated pages currently set the keyboard focus on the search input if it is present, and there is no way to release it other than tabbing out of it or clicking anywhere else on the page. This means that standard ways of keyboard navigation such as scrolling by space or arrow keys do not work without prior intervention.

      On the other hand, the filter input in the sidebar of class pages is not very keyboard friendly either, as there is no shortcut way to activate it, and tabbing through items in the table of contents does not show proper focus highlights.

      Documentation should not steal the focus on page load. Instead, there should be quick keyboard shortcuts to focus both the search and filter inputs, and a keyboard action (such as the escape key) to release focus again. The table of contents in the sidebar should be usable by keyboard, showing proper focus highlights and allowing the focus to be moved with arrow keys in addition to the tab key.

            hannesw Hannes Wallnoefer
            hannesw Hannes Wallnoefer
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: