landmarks

This repository contains a Firefox extension that enables keyboard
navigation of WAI-ARIA landmarks (including implicit landmarks in HTML5
elements). Landmarks may be navigated via hotkey or via the Firefox
Tools menu item. The following WAI-ARIA landmarks are supported:

• application (1)
• banner
• complementary
• contentinfo
• form (1)
• main
• navigation
• region (1)
• search

Note 1: that application, form and region roles are considered navigable
landmarks only when they are labelled with aria-label or aria-labelledby.

Note 2: header and footer elements are not considered landmarks when they
are contained within an article or a section element.

Installation

To install the extension, download the landmarks.xpi file then drag it
over a Firefox window and release. Then follow the installation
instructions.

Navigating Landmarks

Landmarks may be navigated using one of two methods:

1. Navigate landmarks via hot key.

   • Pressing the "n" key navigates forward through landmarks.
   • Pressing the "p" key navigates backward through landmarks.

   The "n" and "p" keys are default navigation keys. The defaults may
   be changed by navigating to Tools --> Add-ons. Select the "Options"
   or "Preferences" button on the "WAI-ARIA landmark keyboard navigation"
   extension.

   Note that some navigation key settings may interfere with other
   application shortcut keys or your browser's shortcut keys.

   Use Tools --> Add-ons --> Options/Preferences, to enable rendering
   a border around an element having a landmark role. Three border options
   are available as follows:

   • No border drawn around focused element
   • Persistent border drawn around focused element
   • Momentary border drawn around focused element

2. Navigate landmarks from the Tools --> Landmarks menu item.

   The landmarks menu item presents a list of page landmarks allowing the
   user to select one. If landmarks are nested, the landmarks menu item
   indents entries to reflect nesting. If landmark labels are present via
   aria-label or aria-labelledby, the labels are shown.

Test Pages

• ARIA landmarks: http://www.html5accessibility.com/tests/roles-land.html
• HTML 5 structural elements: http://www.html5accessibility.com/tests/structural-elements.html