ARIA Label Bookmarklet

I love simple bookmarklets that visualize coding patterns. I was working on a project today and wanted to verify that aria-labels were sufficiently descriptive. So I put together this quick bookmarklet.

aria-label bookmarklet

Simply drag that up to your bookmark bar and click on it whenever you need to test a page.

If an element has an aria-label, it should get a yellow background and the label displayed in red. Your particular styles may affect this.

If an has an aria-labelledby, it should have a pink background and the object it is pointing to will be displayed in green.
I’m labelling the next element

Usage

I’m using this on a project that uses aria-label extensively in a complicated form. In the past, I found some of the aria-label attributes didn’t provide adequate context, so this now makes it pretty simple to discover.

Accessible responsive images

Responsive web design, creating a single page that morphs with the view port size, is a major feature of modern web design. There are many factors to consider for performance and accessibility. This article will touch on responsive design’s impact on image accessibility.
Continue Reading Accessible responsive images

Accessibility + YUI – creating accessible forms

This presentation was created for the YUI Conference, November 2013 by Sarbbottam and Ted Drake. Sample code is available at GitHub Bruce Lee toy photos courtesy [CC] images by Shaun Wong on Flickr. Watch the full presentation (includes closed captions):


You can also view the slides:

Accessibility + YUI

Sarbbottam | Ted Drake YUI Conf 2013

“Mistakes are always forgivable, if one has the courage to admit them.”
― Bruce Lee

1:6 Medicom Bruce Lee Inaccessible web sites are usually caused by ignorance rather than bad intentions. This presentation will introduce what is needed for accessibility and how Sarbbottam used ARIA, JavaScript, Progressive Enhancement, and semantic HTML to create a truly accessible and dynamic form. This will help you with your projects as well.

  • Perceivable
  • Operable
  • Understandable
  • Robust

The WCAG 2.0 accessibility specifications focus on the user’s experience. It distills this to 4 key factors. Essentially, the user needs to know:

  • what is on the page
  • be able to focus on the content
  • interact with the objects
  • the product should work with all combinations of browsers, devices, and assistive technology.

ARIA Today

Action

Now that we have the basics for accessibility, let’s look at how Sarbottam created a visually dynamic form that provides ample feedback for screen reader users. This form includes:

  • Progressive enhancement (works without javascript)
  • Everything is keyboard accessible
  • Works in multi-language/direction/keyboard

Let’s look at how a screen reader interprets our sample form. Watch for the following elements in this video:

  • Each form input has clearly defined label, state, and properties, i.e required.
  • The screen reader lets the user know how to interact with dropdown components
  • Screen changes are announced to the user.

Drop Down

This drop down button uses background images for the flag and triangle. The only text node is the country code value. But is this enough for a user? The drop down updates the button’s aria-label to let the user know the button’s intention. Further, after the user has chosen a country, the aria-label is updated to show it’s selected value.

country code dropdown buttonWhat is this button?

This button includes a flag, a triangle, and the text “+852”. The flag and triangle are using spans with background images. What does the +852 mean? How can the user know exactly what this will do?

<a
    href="#foo"
    role="button"
    aria-haspopup="true"
    aria-label="Hong Kong (+852) Country Code for optional recovery phone number">
        <span class="flag-hk"></span>&nbsp;
        <span class="drop-down-arrow-container">
            <span class="drop-down-arrow"></span>
        </span>
        &nbsp;+852
</a>

Many times people assume their background image is providing enough information. However, background images provide no context for the screen reader or voice recognition user. This drop down button is clearly labeled with the country name, the phone number extension, and the context (optional phone number). Further, the user knows this will generate a menu via the aria-haspopup=”true” attribute. The aria-label attribute is updated when the user selects a new value.

This video shows how the drop down button is announced as a pupup button with the full information. This interaction uses onkeydown to grab the arrow keys. onkeypress was exact character code of the key pressed. This was a problem with international keyboards. Escape key closes the drop down and is announced as the help text. See the aria practices: #focus_tabindex

Live Regions

ARIA live regions trigger screen readers to announce content when it changes on the screen. This could be when an object is given display:block, when content is inserted via innerHTML, or similar moments.

<p
    id="password-validation-message"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all">
</p>

The password field connects to a paragraph that displays the password’s strength with aria-live=”polite”. This paragraph is empty when the page loads, but content will be inserted via JavaScript as the user creates their password. This means the new content will be announced after the user stops typing. Use assertive to interrupt the user. Nothing is announced while it is empty.

<p
    id="password-validation-message"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all">
        Password must contain 8 characters.
</p>

The paragraph now includes text. This will be announced when the user pauses. ARIA live regions can be triggered via innerHTML content changes.

<p
    id="password-validation-message"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all">
        Not bad, but you can make it better.
</p>

Every time the content changes, the user will be notified. You are already doing the presentation changes, the ARIA attributes just surface that content to the assistive technology.

This video shows how the password strength indicator is announced as the user enters their password.

Username Suggestions

autofill suggestions for user name

The username suggestions drop down uses ARIA to define the label and possible error messages. The suggestions have the menu role. Using live regions, a hidden div is used to surface suggested usernames as the user arrows through the choices.

<input
    type="text"
    id="user-name"
    autocomplete="off"
    aria-required="true"
    aria-describedby="validation"
    placeholder="Username"
    aria-labelledby="user-name-label">

The username text input turns off HTML5 autocomplete, uses aria-required for required status, aria-describedby points to potential error message, and aria-labelledby points to the label.

<p class="clipped"
    id="suggestions-read-out-container"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all"></p>

The class hides this paragraph visually. aria-live forces the changes to be announced immediately, aria-atomic announces changed content, not the entire paragraph each time, aria-relevant announces all additions and removals.

This JS snippet shows how the content is inserted into the live region via innerHTML.

highlightSuggestion : function(suggestion) {       
    var readOutText = suggestion.get('innerHTML');       
    suggestion && suggestion.addClass('suggestions-hovered');  
     
    if(this.selectedIndex === this.list.length - 1) {         
        readOutText += this.endOfsuggestionsMessage;       
    }  
     
    this.suggestionsReadOutContainer.set('innerHTML', readOutText);     
},
<p
    class="clipped"
    id="suggestions-read-out-container"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all">
        bruce.ninjamaster.lee
    </p>

This video shows how the username suggestions give the user information on available options and how to navigate

Validation

This form includes some basic form validation. When an input has been defined as invalid, we will add the aria-invalid=”true” attribute

<input
    type="text"
    aria-required="true"
    aria-describedby="name-message"
    placeholder="First name"
    aria-labelledby="first-name-label">
<p
    id="name-message"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all">
    </p>

The input is connected to the error message container via aria-describedby. The paragraph container has aria-live=”assertive” to announce the error message when it is populated.

<input
    type="text"
    aria-required="true"
    aria-describedby="name-message"
    placeholder="First name"
    aria-invalid= "true"
    aria-labelledby="first-name-label">
<p
    id="name-message"
    aria-live="polite"
    aria-atomic="false"
    aria-relevant="all">
        Enter Name
</p>

Add aria-invalid=”true” to the input when it is defined as invalid. The error message will be announced as soon as it is populated due to the aria-live attribute. The error message will also be announced when the user places focus in the input.

This video shows the First and last name inputs. The initial focus announces the placeholder, label, and the required state. It also shows the error state inputs are announced as invalid and the error message is read as the help text. NVDA and JAWS on windows will announce the error message without the delay.

Yahoo User Interface Library

Accessibility is built into all YUI widgets. All YUI widgets include ARIA, Keyboard accessibility, and HTML best practices. Use these with confidence. Please note: 3rd party components within the gallery may not be accessible.

Debugging aria-label on elements

Sat, Sun, Mon - Forecast iconsI recently helped do some testing on the new version Yahoo! Mail for iPads and was stumped by an aria-label not working as expected. It was one of those gotcha moments, when you realize a confusion with a fundamental process. Are you wondering why your aria-label is not being announced?

It’s tempting to use the aria-label attribute in situations where the visible text is not adequate. For instance, you may use a background image to represent a value and you’d like the user to know that value via an aria-label on the parent.

This basic test page will walk through the simple assumption and show how the aria-label is meant to be used.

Continue Reading Debugging aria-label on elements