Find aria-hidden with this bookmarklet

Use this bookmarklet to find aria-hidden attributes on your page. Continue Reading Find aria-hidden with this bookmarklet

I love purpose built bookmarklets that help you find problematic code. I got an email yesterday from Travis Roth about a potential vestigial aria-hidden attribute on an otherwise visible element. Unfortunately, it’s not uncommon to find an element that has aria-hidden=”true” on an element that is visible and should have either “false” or no aria-hidden attribute. This causes assistive technology to ignore the element.

My first reaction was to search the code for aria-hidden attributes, but this can take time and would have to be completed on each page to find the issue.

So I created the following bookmarklet that will find any element on your page that uses aria-hidden. It will force it to be visible and will display the attribute’s value.

screenshot showing the bookmarklets effect on hidden elements

To use this bookmarklet, drag the following link to your bookmark toolbar. Visit your questionable page and click the link.

aria-hidden bookmarklet
Continue Reading Find aria-hidden with this bookmarklet

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.

Use aria-labelledby to provide context to unordered lists

VoiceOver announces the heading when the list is selected

It’s not uncommon for a web page to include multiple sets of lists. This is especially true for a web site that aggregates information. The Yahoo! Finance home page contains at least 12 lists.

Screen readers allow the user to navigate a page via lists and announce the number of items in each list. But what if we could make this navigation more relevant? This can be done via the aria-labelledby attribute.

Continue Reading Use aria-labelledby to provide context to unordered lists

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.

Hitting the accessibility high notes with ARIA

ARIA (Accessible Rich Internet Applications) allows web developers to make their complex web applications accessible. This presentation will introduce ARIA attributes and how they establish landmarks, states, and roles. Learn how to use the basic elements that belong on every application. This presentation will also show more advanced topics, such as invalid form inputs, live regions, and fixing divitis.

Continue Reading Hitting the accessibility high notes with ARIA