README

18F Aria-Accordion

About

A simple, accessible JavaScript accordion.

Getting started

Download

Via npm

npm install aria-accordion

Set up your HTML

    <ul class="js-accordion">
        <li>
          <button>
            First Amendment
          </button>
          <div>
            <p>
            Congress shall make no law respecting an establishment of religion, or prohibiting the free exercise thereof; or abridging the freedom of speech, or of the press; or the right of the people peaceably to assemble, and to petition the Government for a redress of grievances.
            </p>
          </div>
        </li>
        <li>
          <button>
            Second Amendment
          </button>
          <div>
            <p>
            A well regulated Militia, being necessary to the security of a free State, the right of the people to keep and bear Arms, shall not be infringed.
            </p>
          </div>
        </li>
   </ul>

Simply create a series of <button> elements followed by <div>s and this will take care of the rest, adding the proper ARIA attributes. You can add custom IDs to the <div>s and the library will default to those. If you don't add IDs the library will generate them for you.

Initialize

In whichever file you initialize your JavaScript components, initialize the accordion like so:

    var accordion = require('@18f/accordion');

    // Required element to turn into an accordion
    var elm = document.querySelector('.js-accordion');

    // Optional configurion objects
    var selectors = { ... };
    var opts = { ... };

    new accordion.Accordion(elm, selectors, opts);

Configuration

The constructor requires an HTML element to turn into the accordion.

The constructor accepts an optional hash of selectors as its second parameter:

trigger: CSS selector for the elements to turn into the accordion triggers. The component will look for these items' next sibling to turn into the accordion content that is hidden and revealed. Default: button

You can also pass a hash of options. Currently, the only option is:

collapseOthers: Boolean for whether or not to collapse all other panels when one panel is open. Default: false
customHiding: Boolean for whether or not to use your own CSS to hide collapsed content areas. Default: false
contentPrefix: String prefix for the content div IDs in order to have multiple accordions on the same page. Default: accordion
openFirst: Boolean for whether or not to open the first item by default. Default: false
reflectStatic: Boolean for whether or not the accordion should reflect any attributes (aria-hidden and aria-expanded) that were rendered statically. Default: false

Styling

You're free to add classes and style your markup however you please. By default, the component sets any content element with [aria-hidden="true"] to display: none inline, but you can override this to use your own custom hiding styles with the customHiding property. To style the buttons when they panel is open vs closed, target [aria-expanded="true"].

License

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

Usage no npm install needed!