Web Content Accessibility Guidelines

Non-text content (i.e., attachments, tables, figures etc.) should contain appropriate descriptions to improve accessibility and align with WCAG 2.2 AA.

• For images:
  • The alt parameter should be used when inserting an image with the Image macro and Gallery Macro. For example:
    • {{image reference="image-name.png" size=".." alt="A good alternative text for the image"/}}

    • {{gallery}} 
      [[image:first-image-name-in-gallery.png||alt="Image one description"]]
      [[image:second-image-name-in-gallery.png||alt="Image two description"]]
      {{/gallery}}

  • The title attribute can also be used to provide supplementary information and help users better understand the image context, but it should not replace the alt text, which remains mandatory for accessibility. For example:

    • {{gallery}}
      [[image:first-image.png||alt="Image description" title="Additional information about the image"]]
      [[image:second-image.png||alt="Another image description" title="More details about this image"]]
      {{/gallery}}

  • The caption parameter could also be used for adding brief visible content under the image. Do not use this parameter to indicate the XWiki version in which the screenshot was taken. Instead, use it only for meaningful content that provides useful context about the image.
• For diagrams, make sure to use Accessible Colors.