Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

With JAWS active, how can I read flow action labels

SA-11294

Summary



You are using Job Access With Speech (JAWS) assistive technology software to read your accessible application. When you create a new work object, the focus / cursor moves to the first editable field. JAWS does not read the label associated with the flow action under which this field is present. Due to this, you are uninformed about which screen or action you are on.

Error Messages



No Error Message , but since the focus directly shifts to the first input field , the non-focused sections are not read out.

Steps to Reproduce



1. Enable a Pega 7 application with the latest Accessibility Framework
2. Build a simple process flow with sections including Read only sections , input fields, buttons, and Dropdowns.
3. Launch the end user portal and open the work object with JAWS active.
4. Verify if JAWS reads out the flow action that is displayed on the screen.


Root Cause



Starting with Pega7, the expected behavior is that the focus should not fall on any particular control as such and arrow keys (or tab) should be used to navigate the labels, inputs, and other static texts. This is expected best practice for Accessibility tools.

Resolution



Perform this local change:

In the UserWorkForm HTML fragment, insert the following script.

 
<script>
pega.util.Event.addListener(window,"load",function(){
   document.activeElement.blur();
   window.focus();
    if($(".actionTitleBarLabelStyle").length > 0){
        $($(".actionTitleBarLabelStyle")[0]).attr("role","heading");
        $($(".actionTitleBarLabelStyle")[0]).attr("aria-level","2");
    }   
});
</script>



This script will read the flow action label when a user presses the “H” key.

 
Suggest Edit

Published July 10, 2015 - Updated October 8, 2020

Did you find this content helpful? Yes No

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us