Last modified by Vincent Massol on 2026/11/14 22:50

Show last authors
1 Non-text content (i.e., attachments, tables, figures etc.) **should** contain appropriate descriptions to improve accessibility and align with [[WCAG 2.2 AA>>Community.Accessibility.WebHome]].
2
3 * For images:
4 ** The {{code language="none"}}alt{{/code}} parameter should be used when inserting an image with the [[Image macro>>extensions:Extension.Old XWiki 1\.0 syntax renderer.Image Macro (Radeox)]] and [[Gallery Macro>>||anchor="HGalleryMacro"]]. For example:(((
5 * {{code language="none"}}{{image reference="image-name.png" size=".." alt="A good alternative text for the image"/}}{{/code}}
6 * (((
7 {{code language="none"}}
8 {{gallery}}
9 [[image:first-image-name-in-gallery.png||alt="Image one description"]]
10 [[image:second-image-name-in-gallery.png||alt="Image two description"]]
11 {{/gallery}}
12 {{/code}}
13 )))
14 )))
15 ** The {{code language="none"}} title{{/code}} attribute can also be used to provide supplementary information and help users better understand the image context, but it should not replace the {{code language="none"}}alt{{/code}} text, which remains mandatory for accessibility. For example:(((
16 * (((
17 {{code language="none"}}
18 {{gallery}}
19 [[image:first-image.png||alt="Image description" title="Additional information about the image"]]
20 [[image:second-image.png||alt="Another image description" title="More details about this image"]]
21 {{/gallery}}
22 {{/code}}
23 )))
24 )))
25 ** The {{code language="none"}}caption{{/code}} 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.
26 * For diagrams, make sure to use [[Accessible Colors>>Community.DocGuide.WorkingAttachments.Diagrams.WebHome||anchor="HAccessibleColors"]].

Get Connected