Accessibility

Last modified by Thiago Krieck on 2026/11/18 14:13

Warning
Draft

This page is a draft. The standards on it are proposals still under discussion, so they may change and should not be treated as final yet.

The standard

  • Target: All XWiki UI should meet WCAG 2.2 level AA, since this is the level XWiki has committed to.
  • Semantics first: Native HTML elements (<button>, <label>, <dialog>-like Bootstrap modals with role="dialog") should be preferred over ARIA, since they bring keyboard and screen reader support for free.
  • Keyboard: Everything that can be done with a mouse should be doable with the keyboard, with a visible focus indicator.
  • Names: Every control should have an accessible name, including icon-only buttons and repeated actions in lists. See Buttons and Action labels.
  • Automated checks: UI tests run axe-core against the WCAG 2.0, 2.1 and 2.2 A/AA rules. A new violation should be fixed rather than added to the list of rules that only warn.
  • Manual checks: Color contrast, labels, target size, scrollable regions and links inside text are not enforced by the automated checks, so they should be checked by hand for any new UI.

Testing

  • Java UI tests: run the functional tests with -Dxwiki.test.ui.wcag=true to validate every page a test visits. Reports are written to target/wcag-reports/.

More

Get Connected