Accessibility improvements for webhelp

Are you missing a feature? Request its implementation here.
shudson310
Posts: 156
Joined: Sat Feb 26, 2005 12:09 am
Location: USA
Contact:

Accessibility improvements for webhelp

Post by shudson310 »

Just a suggestion, but a fairly easy addition to the webhelp templates to improve accessibility. This is based on the information at: http://diveintoaccessibility.info/day_1 ... links.html

In the wt_index.html and wt_topic.html templates, after:

Code: Select all

<body class="wh_main_page">
or

Code: Select all

<body class="wh_topic_page">
Add:

Code: Select all

<a class="skiplink" href="#startcontent">Skip over navigation</a>
After:

Code: Select all

<div class="wh_content_area">
or

Code: Select all

<div class="row wh_content_area">
Add:

Code: Select all

<a name="startcontent" id="startcontent"></a>
Next, in wt_default.css, add:

Code: Select all

.skiplink {display:none}
Scott Hudson
Staff Content Engineer
Site: docs.servicenow.com
shudson310
Posts: 156
Joined: Sat Feb 26, 2005 12:09 am
Location: USA
Contact:

Re: Accessibility improvements for webhelp

Post by shudson310 »

Also, based on https://www.w3.org/TR/WCAG20-TECHS/ARIA11.html, it's also a good idea to add:

Code: Select all

 id="content" role="main" 
to the div wrapper for both:

Code: Select all

<div id="content" role="main" class="wh_content_area">
in wt_index.html
and

Code: Select all

<div id="content" role="main" class="row wh_content_area">
Scott Hudson
Staff Content Engineer
Site: docs.servicenow.com
shudson310
Posts: 156
Joined: Sat Feb 26, 2005 12:09 am
Location: USA
Contact:

Re: Accessibility improvements for webhelp

Post by shudson310 »

shudson310 wrote:Also, based on https://www.w3.org/TR/WCAG20-TECHS/ARIA11.html, it's also a good idea to add:

Code: Select all

 id="content" role="main" 
to the div wrapper for both:

Code: Select all

<div id="content" role="main" class="wh_content_area">
in wt_index.html
and

Code: Select all

<div id="content" role="main" class="row wh_content_area">
in wt_topic.html
Scott Hudson
Staff Content Engineer
Site: docs.servicenow.com
bogdan_cercelaru
Posts: 222
Joined: Tue Jul 01, 2014 11:48 am

Re: Accessibility improvements for webhelp

Post by bogdan_cercelaru »

Hello,

Thank you for your suggestions.
I've added your request in our issue tracking system to be addressed by one of our developers.

Regards,
Bogdan
Bogdan Cercelaru
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
Post Reply