Page 1 of 1

Side TOC not accessible using standard keystrokes

Posted: Tue Mar 01, 2022 8:38 pm
by rjcbop
We're currently in the process of testing our responsive webhelp against the WCAG 2.1 standard and have discovered that the side TOC (wh_publication_toc) does not appear to honor some of the standard keystrokes for navigating the tree. For example, according to the WAI-ARIA Authoring Practices for treeviews (https://www.w3.org/TR/wai-aria-practices-1.1/#TreeView), the right arrow key should expand a collapsed node and the left arrow key should collapse an expanded node, but they don't. Also, the up and down arrow keys should navigate up and down the tree (without expanding or collapsing nodes) but they don't.

Thanks for any information regarding these issues.

Re: Side TOC not accessible using standard keystrokes

Posted: Fri Jan 06, 2023 8:27 pm
by rjcbop
Resurfacing this issue to see if the Oxygen team has any plans to modify the keyboard accessibility of the side TOC in responsive webhelp. Although the TOC is technically keyboard accessible, it isn't accessible in the standard way (as described in https://www.w3.org/WAI/ARIA/apg/example ... ation.html). Although we've documented this behavior in a topic about accessibility within our help system, we've recently been informed by our 508 compliance consultant (Level Access) that these instructions would need to be provided on every page that has the side TOC, which of course is not feasible.

Since we already have a substantial amount of customized javascript, we're considering writing javascript to implement the standard keyboard accessibility for a treeview but wanted to check with the Oxygen team before going down that road.

Thanks for any feedback on this issue.

Re: Side TOC not accessible using standard keystrokes

Posted: Mon Jan 09, 2023 12:56 pm
by Costin
Hi rjcbop,

I confirm that there is an issue with the arrow keys navigation in the output TOC.
However, you could navigate using the TAB Shift+TAB keys and you could also use SPACE to toggle the expand/collapse state for a topic in the TOC.

As we are aware of this issue and already have it logged in our internal tracking system, I also added your feedback and tried to increase its priority.
When/if a new implementation will be available in a future version of Oxygen, we will notify this thread.

Regards,
Costin

Re: Side TOC not accessible using standard keystrokes

Posted: Tue Jan 10, 2023 5:21 pm
by rjcbop
Thanks!