Accessibility
Last modified by Thiago Krieck on 2026/11/18 14:13
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/.