Accessibility"

From Documentation
Line 25: Line 25:
  
  
To ensure za11y.jar running as expected, you can simply inspect a textbox, please see [[#Built-in Support|Built-in Support]]
+
To ensure za11y.jar running as expected, you can simply inspect a textbox. If you see ARIA attributes rendered in the element, that means the module works successfully. Please see [[#Built-in Support|Built-in Support]]
  
 
= Built-in Support =
 
= Built-in Support =

Revision as of 06:15, 28 September 2020


Accessibility



Since 9.5.0

  • Available for ZK:
  • http://www.zkoss.org/product/zkhttp://www.zkoss.org/whyzk/zkeeVersion ee.png

Overview

To meet accessibility, it requires semantic information about widgets, structures, and behaviors for assistive technologies. ZK widgets already render semantic information based on their purposes according to WCAG 2.0 and WAI-ARIA. But as a UI framework, we make widgets be flexible for multiple user scenarios. A widget might play a different role in a different page. It depends on the application developers' design. Therefore, we need the application developer's cooperation to achieve complete accessibility. This chapter tells you what ZK framework has done, and how you can add more application-specific accessibility information.



Enable Accessibility Support

ZK accessibility module is a separate, optional jar, you have to include it manually to enable it.

		<dependency>
			<groupId>org.zkoss.zk</groupId>
			<artifactId>za11y</artifactId>
			<version>${zk.version}</version>
		</dependency>


To ensure za11y.jar running as expected, you can simply inspect a textbox. If you see ARIA attributes rendered in the element, that means the module works successfully. Please see Built-in Support

Built-in Support

To know what ZK already renders which ARIA attributes by default, please open the developer tool to inspect a widget.

textbox.zul

<textbox />

Visit the zul page and Inspect the textbox with a browser developer tool, you will see:

<input id="h5AP0" class="z-textbox" type="text" 
       aria-disabled="false" aria-readonly="false">




Last Update : 2020/09/28

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.