RFR: 8350638: Make keyboard navigation more usable in API docs [v6]

[Hannes Wallnöfer]

On Mon, 3 Mar 2025 17:32:03 GMT, Weijun Wang <weijun at openjdk.org> wrote:

> The keyboard shortcuts are great! However, I don't quite get what "be navigated with the up/down arrow keys and lives up to the job of navigating to any page section very quickly" means. If I press the up/down keys I can see the right side is scrolling (in a constant speed) and whatever section shows up is highlighted on the left side. How do I navigate to a section quickly? I thought you meant every down key press will jump to the next section.

Sorry for being imprecise, what I meant was this: 

 - type something in the left side "Filter" input
 - press tab or arrow-down key to move focus to the first item in the list
 - optionally navigate with tab/shift-tab/arrow keys to the list item of choice
 - hit enter to go to the item and reset the filter input

So the only way to get the orange highlight that can be moved by tab/arrow keys is via tabbing/arrowing out of the filter input box. That's because this is the keyboard focus, which can't be set by mouse/trackpad.

Unfortunately Safari has a bug where the focus sometimes does not show when pressing arrow-down from the filter input, but tab should always work. The bug has already been fixed and will hopefully be in the released version soon.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/23777#issuecomment-2695303284