Directory

AriaButton Add-on

Add aria-label, aria-labelledby, and aria-describedby attributes to Button for improved accessibility

An extension for adding aria-label, aria-labelledby, and aria-describedby attributes to Button. Support in IE is limited, and ZoomText reads aria-describedby attribute only in Finder tool.

Tested with most used screen readers and browsers:

Windows 10 (Chrome, Firefox, Edge, IE11)
• NVDA 2017.3
• JAWS 18
• ZoomText

iOS 10 (Safari, Chrome)
• VoiceOver

Sample code

// use aria-label, when button doesn't have visible descriptive text, 
// and aria-describedby for more verbose information
 final Button yButton = new Button("Y");
 AriaButton.extendAriaLabel(yButton, "Vertical");
 AriaButton.extendAriaDescribedBy(yButton,  "The Y-axis is the vertical axis");

// use aria-labelledby, when button has visible descriptive text
final Button openButton = new Button("Open");
AriaButton.extendAriaLabelledBy(openButton, "Open");
AriaButton.extendAriaDescribedBy(openButton, "This is a button for opening");

Links

• Source code
• Issue tracker
• Author Home Page
• WAI-ARIA 1.0 W3C Recommendation
• ARIA examples

Compatibility