RevealJS A11y

Slides people can actually use.

What the a11y plugin adds to a RevealJS presentation, how to enable it, and the controls it gives a reader.
Author

Mickaël CANOUIL, Ph.D.

A slide deck is one of the least accessible things on the web: text scaled to a projector, transitions that move without asking, no way to enlarge anything, and a screen reader that announces nothing as the slides change.

a11y fixes what can be fixed from a plugin. It adds a skip link, real focus indicators, font size and spacing controls, a transcript, a pointer indicator, and announcements as slides and fragments change, all reachable from a settings menu and from the keyboard.

Installation

quarto add mcanouil/quarto-revealjs-a11y@0.2.2

This will install the extension under the _extensions subdirectory. If you are using version control, you will want to check in this directory.

Or install it from your editor with Quarto Wizard:

Visual Studio Code Positron VSCodium

Quick start

format:
  revealjs:
    revealjs-plugins:
      - a11y

That is enough: most of what it does is on by default.

Try it

The preview deck is built by this site with every control enabled. Press A for the settings menu, or use +, -, 0, T, and P.

See the Reference for every option, and the Examples for the configuration behind the deck.

Where it works

RevealJS.

The transcript can also be printed below each slide in print-pdf output, which is the one part that survives beyond the browser.

Back to top