Feedback on javadoc UI changes

Hannes Wallnöfer hannes.wallnoefer at oracle.com
Thu Oct 10 11:08:40 UTC 2019


Thanks for the hint, Sergey.

(Removing jdk-dev but leaving javadoc-dev recipient as this is a more technical issue.)

The changes I have done should have no effect for a11y tools like screen readers. We do have an invisible „Skip navigation links“ link though that should allow skipping over nav bar content. I haven’t tested it with a screen reader yet, and I’m not sure it was there when you tried. It would be a good idea to find out it is working as intended.

Hannes


> Am 10.10.2019 um 00:03 schrieb Sergey Bylokhov <Sergey.Bylokhov at oracle.com>:
> 
> 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 javadoc-dev mailing list