Feedback on javadoc UI changes (original) (raw)

Sergey Bylokhov Sergey.Bylokhov at oracle.com
Wed Oct 9 22:03:39 UTC 2019

Hi, Hannes.

I have one unrelated suggestion. When I fixed some a11y related bugs in the specification, I have tried to check the fix by the VoiceOver tool. And it was really hard to navigate over the search_fields/links/text by the keyboard using VoiceOver. Probably it can be improved somehow.

On 10/9/19 10:29 am, Hannes Wallnöfer wrote:

The javadoc team is considering changes to the UI of javadoc generated pages, specifically the behaviour of the top navigation bar and navigating to anchors within a page. Since this would affect all JDK users we thought it was a good idea to present/discuss the alternatives here on jdk-dev.

The feedback we are looking for: - What do you prefer for scrolling up and down a page? Do you find the moving parts useful or distracting? - Which version is best for navigating to an anchor within a page (e.g. member search or internal links)? - Do you experience any technical problems with your particular browser? Here are the three versions: Version 1 is the conservative fix, it retains the fixed navigation bar, changes are mostly under the hood: http://cr.openjdk.java.net/~hannesw/8223378/api.00/ Version 2: When scrolling down, the navigation bar slides upwards and disappears. When scrolling back up or starting to type for a search, it slides back in again. http://cr.openjdk.java.net/~hannesw/8230852/api.04/ Version 3: Like version 2, but the part of the navigation bar that contains the search box and page-local links always remains visible. There’s an arrow symbol on the left to make the full navigation bar reappear. http://cr.openjdk.java.net/~hannesw/8230852/api.03/ Hannes

-- Best regards, Sergey.

More information about the jdk-dev mailing list