Jump to Table of Contents

Example: Accessible Toolbar

This example illustrates how to create an accessible toolbar using the Focus Manager Node Plugin and Node's support for the WAI-ARIA Roles and States.

(Accessible Toolbar results here)

Setting Up the HTML

Start with a set of <input> elements. For the purpose of this example, the type attribute of each button will be set to a value of "button" since they won't be responsible for submitting a form. Each <input> is wrapped by two <span>s that serve as decorator elements used to style each button with rounded corners.

<div id="toolbar-1" class="yui3-toolbar">
    <span id="add-btn" class="yui3-toolbar-button first-child"><span><span><input type="button" name="btn-add" value="Add"></span></span></span>
    <span id="edit-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-edit" value="Edit"></span></span></span>
    <span id="print-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-print" value="Print"></span></span></span>
    <span id="delete-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-delete" value="Delete"></span></span></span>
    <span id="open-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-open" value="Open"></span></span></span>
    <span id="save-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-save" value="Save"></span></span></span>
</div>

Setting Up the CSS

Next, each button in the toolbar is styled with rounded corners using a combination of the CSS border property along with the use of negative margins. An icon is added to each button using a background image. Following the advice of the Exceptional Performance team, this example uses the technique of CSS Sprites, combining all of the icons for each button into a single image to reduce HTTP requests.

.yui3-toolbar {
    border: solid 1px #999;
    background-color: #ccc;
    margin: .25em;
    overflow: auto;
}

.yui3-toolbar-button {
    display: inline-block;
    border-width: 1px 0;
    border-style: solid;
    border-color: #808080;
    background-color: #dfdfdf;
    margin: .25em;
    font-size: 85%;  /* 11px */
}

.first-child {
    margin-left: .5em;
}

.yui3-toolbar-button span {
    display: inline-block;
    border-width: 0 1px;
    border-style: solid;
    border-color: #808080;
    margin: 0 -1px;
    *position: relative;    /* Necessary to get negative margins working in IE */
    *left: -1px;
}

.yui3-toolbar-button span span {
    display: inline-block;
    border: solid 1px #b6b6b6;
    margin: 0;
    *position: static;
}

.yui3-toolbar-button input {
    border: none;
    margin: 0;
    padding: 4px 4px 4px 24px;
    *overflow: visible; /* Remove superfluous padding for IE */
    background: transparent url(../assets/node-focusmanager/icons.png) no-repeat;
}

#add-btn input {
    background-position: 4px -102px;
    *background-position: 4px -100px;
}

#edit-btn input {
    background-position: 4px -78px;
    *background-position: 4px -76px;
}

#print-btn input {
    background-position: 4px -54px;
    *background-position: 4px -52px;
}

#open-btn input {
    background-position: 4px -30px;
    *background-position: 4px -28px;
}

#delete-btn input {
    background-position: 4px -126px;
    *background-position: 4px -124px;
}

#save-btn input {
    background-position: 4px -6px;
    *background-position: 4px -4px;
}

Initializing the Focus Manager

With the toolbar markup and CSS in place, retrieve the Node instance representing the toolbar (<div id="toolbar-1">) and call the plug passing in a reference to the Focus Manager Node Plugin as the first argument, and a collection of configuration attributes as the second argument.

The Focus Manager's descendants attribute is set to a value of "input", so that only one button in the toolbar is in the browser's default tab flow. This allows users navigating via the keyboard to use the tab key to quickly move into and out of the toolbar. Once the toolbar has focus, the user can move focus among each button using the left and right arrows keys, as defined by the value of the keys attribute. Lastly, the focusClass attribute is used to apply a class of focus to each <input> when it is focused, making it easy to style the focused state in all browsers.

YUI().use("node-focusmanager", function (Y) {

    //  Retrieve the Node instance representing the toolbar
    //  (<div id="toolbar">) and call the "plug" method
    //  passing in a reference to the Focus Manager Node Plugin.

    var toolbar = Y.one("#toolbar-1");

    toolbar.plug(Y.Plugin.NodeFocusManager, {

            descendants: "input",
            keys: { next: "down:39", // Right arrow
                    previous: "down:37" },  //  Left arrow
            focusClass: "focus",
            circular: true

         });


    //  Set the ARIA "role" attribute of the Node instance representing the
    //  toolbar to "toolbar" to improve the semantics of the markup for
    //  users of screen readers.

    toolbar.set("role", "toolbar");


    //  Listen for the click event on each button via the use of the
    //  "delegate" method

    toolbar.delegate("click", function (event) {

        alert("You clicked " + this.one("input").get("value"));

    }, ".yui3-toolbar-button");

});

Styling Focus

To augment the browser's default styling of the focused state define a CSS selector that adds a background color to the

/*  Augment the browser's default styling of the focus state by changing the
    background color of the button when it is focused.  */

.yui3-toolbar-button input.focus {
    background-color: #B3D4FF;
}

Complete Example Source

<div id="toolbar-1" class="yui3-toolbar">
    <span id="add-btn" class="yui3-toolbar-button first-child"><span><span><input type="button" name="btn-add" value="Add"></span></span></span>
    <span id="edit-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-edit" value="Edit"></span></span></span>
    <span id="print-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-print" value="Print"></span></span></span>
    <span id="delete-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-delete" value="Delete"></span></span></span>
    <span id="open-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-open" value="Open"></span></span></span>
    <span id="save-btn" class="yui3-toolbar-button"><span><span><input type="button" name="btn-save" value="Save"></span></span></span>
</div>
<div id="out">(Accessible Toolbar results here)</div>

<script>

    YUI().use("node-focusmanager", function (Y) {

        //  Retrieve the Node instance representing the toolbar
        //  (<div id="toolbar">) and call the "plug" method
        //  passing in a reference to the Focus Manager Node Plugin.

        var toolbar = Y.one("#toolbar-1"),
            out     = Y.one("#out");

        toolbar.plug(Y.Plugin.NodeFocusManager, {

                descendants: "input",
                keys: { next: "down:39", // Right arrow
                        previous: "down:37" },  //  Left arrow
                focusClass: "focus",
                circular: true

             });


        //  Set the ARIA "role" attribute of the Node instance representing the
        //  toolbar to "toolbar" to improve the semantics of the markup for
        //  users of screen readers.

        toolbar.set("role", "toolbar");


        //  Listen for the click event on each button via the use of the
        //  "delegate" method

        toolbar.delegate("click", function (event) {

            out.setHTML("You clicked " + this.one("input").get("value"));

        }, ".yui3-toolbar-button");

    });

</script>