Wiki source code of Accessibility
Last modified by Vincent Massol on 2026/11/14 22:50
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
12.2 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
 |
1.1 | 4 | |
| |
50.1 | 5 | The XWiki project follows the [[Web Content Accessibility Guidelines (WCAG) 2.2>>https://www.w3.org/TR/WCAG22/]] at the AA level. All features, and especially new ones, must comply with them. The [[Accessibility Statement>>doc:xwiki:documentation.xs.user.accessibility.WebHome]] holds the public commitment and the current conformance status. |
 |
23.1 | 6 | |
| |
50.1 | 7 | The [[Accessibility Manager>>Community.DevelopmentPractices||anchor="HAccessibilityManagerRole"]] keeps the statement up to date, organizes the audits and monitors the automated test results. |
| |
25.1 | 8 | |
| |
50.1 | 9 | = How Accessibility Is Ensured = |
| |
1.1 | 10 | |
| |
50.1 | 11 | * [[Development Rules>>Community.Accessibility.DevelopmentRules.WebHome]]: the HTML and CSS rules that the automated tests can't check. |
| 12 | * [[Automated Testing>>Community.Accessibility.AutomatedTesting.WebHome]]: Axe Core validation in the functional tests. It finds about half of the issues. | ||
| 13 | * [[Manual Testing and Audits>>Community.Accessibility.ManualTesting.WebHome]]: needed for the other half, to fully pass WCAG 2.2 AA. | ||
| 14 | * [[Tools and Resources>>Community.Accessibility.Resources.WebHome]]: browser extensions, validators and checklists. | ||
| |
40.1 | 15 | |
| |
50.1 | 16 | Related pages elsewhere: |
| |
20.1 | 17 | |
| |
50.1 | 18 | * Documentation: [[accessibility of attachments, images and tables>>Community.DocGuide.WorkingAttachments.wcag.WebHome]] and [[accessible diagram colors>>Community.DocGuide.WorkingAttachments.Diagrams.WebHome||anchor="HAccessibleColors"]]. |
| 19 | * Vue components: [[Test the accessibility of a Vue component>>doc:xwiki:documentation.xs.dev.front-end.test.test-vue-component-accessibility.WebHome]]. | ||
| 20 | * Design: [[WCAG validation in build>>design:Proposal.WCAG21validationinbuild]], the design of the automated testing. | ||
| |
20.1 | 21 | |
| |
50.1 | 22 | = Report an Accessibility Issue = |
| |
1.1 | 23 | |
| |
50.1 | 24 | * Search the [[open accessibility issues>>https://jira.xwiki.org/issues/?jql=labels%20%3D%20wcag%20AND%20resolution%20%3D%20Unresolved]] first, with a few keywords. |
| 25 | * Add the ##wcag## label to the issue. | ||
| 26 | * Fill the ##WCAG 2.1 Rule ids## field with the number and name of the broken success criterion, for example ##2.4.1 Bypass Blocks##. | ||
| 27 | * Add a screenshot of the element, showing both the page and its DOM tree. | ||
| |
12.2 | 28 | |
| |
24.1 | 29 | = History = |
| |
20.1 | 30 | |
| |
45.2 | 31 | * {{version since="18.10.0RC1"}}The Dutch Web Guidelines validation has been removed from the build. Our accessibility commitment is WCAG 2.2 AA, validated by Axe Core, and the DWG checks were either not WCAG requirements, AAA-only, obsolete, or already covered by Axe Core or the HTML5 validator.{{/version}} |
| |
50.1 | 32 | * {{version since="15.8"}}Incomplete checks and per test suite statistics are written to report files.{{/version}} |
| 33 | * {{version since="15.5"}}Improved log traces of WCAG validation.{{/version}} | ||
| 34 | * {{version since="15.2"}}XWiki uses Axe Core to validate accessibility.{{/version}} | ||
| 35 | * {{version before="15.2"}}XWiki was using the Dutch Web Guidelines to validate accessibility.{{/version}} | ||
| 36 | * {{version product="XWiki Enterprise" since="2.1"}}A first manual WCAG testing session checked the main pages against the Dutch Web Guidelines validator.{{/version}} | ||
| |
20.1 | 37 |
