accessible-menu

accessible-menu

A JavaScript library to help you generate WAI-ARIA accessible menus in the DOM.

Installation

NPM

NPM is recommended for large-scale development, since it works well with bundlers like Webpack or Rollup.

# latest stable
npm install accessible-menu

CDN

For learning/prototyping purposes you can use the latest version with:

<script src="https://cdn.jsdelivr.net/npm/accessible-menu/dist/accessibleMenu.js"></script>

For production environments, it is recommend to use a specific version to avoid unforseen breaking changes:

<script src="https://cdn.jsdelivr.net/npm/accessible-menu@1.0.0-beta.1/dist/accessibleMenu.js"></script>

Usage

To use accessible-menu, you first need to ensure your menu follows a basic menu structure.

<menu>
    <menu-item><a>...</a></menu-item>
    <menu-item-with-dropdown>
        <dropdown-toggle />
        <dropdown-menu>
            <menu-item><a>...</a></menu-item>
            ...
        </dropdown-menu>
    </menu-item-with-dropdown>
    <menu-item><a>...</a></menu-item>
    ...
</menu>

include the root menu or bundled library in your project:

import AccessibleMenu from 'accessible-menu';

or

<script src="path/to/accessible-menu/dist/accessibleMenu.js"></script>

Once you have accessible-menu loaded, simply declare a new menu object and initialize it.

const menu = new AccessibleMenu(
    menuDOMObject,
    "menu-item-css-selector",
    "menu-item-with-dropdown-css-selector",
    "dropdown-toggle-css-selector",
    "dropdown-menu-css-selector",
    "class-to-open-menus"
);

menu.initialize();

Want more detailed usage information? It's on the way! Check back for a later release which will include much more documentation.

Versioning

This project uses Semantic Versioning 2.0.0 to keep track of releases.

For more detailed information about SemVer, please see the official documentation.

Development

Set up

Run npm install.

This will ensure you have all the dependencies needed to properly lint your code and commits.

Committing

This project uses the conventional commit standard, which means your commits should follow a basic template of:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

For more detailed information about available types, scopes, breaking changes, etc. please see the official documentation.

This project also provides a command to assist you in formatting commit messages using commitizen:

npm run commit

Coding standards

This project follows a set of coding standards combining StandardJS, Prettier, and JSDoc.

To check your code, you can use ESLint with the provided script:

npm run lint

You can also fix some violations automatically using:

npm run fix

Changelog

1.0.0-beta.2 (2019-11-20)

Features

• menu: add aria-controls to menu toggles (ed3cfd2), closes #9
• menu: add aria-label/labelledby to submenus (6f6f2ac), closes #10
• menu: add basic type error handling (b705d47), closes #26
• menu: compile menu through babel (46d4efd)

Build System

• npm: add babel (4910dcc)

Documentation

• contributing: update contributing guidelines with more information (8b7563b)
• development: add specific release documentation (84f908c)
• menu: add usage documentation (5552e68), closes #25