All viewer components support ARIA (Accessible Rich Internet Applications) roles and attributes to improve integration with assistive technologies such as screen readers.
The top-level viewer element has role
aria-label attribute set by default to the name of the viewer. You can control the label with the
Container.LABEL localization symbol.
Buttons have the role
button and descriptive text set with
aria-label attribute. The value of
aria-label attribute is populated from the value of the button’s localization symbol. When a button is disabled,
aria-disabled attribute is set accordingly.
The main view has role
application. A brief description of the main view is provided in
aria-roledescription, with the value defined by the
ROLE_DESCRIPTION localization symbol of the corresponding main view component. Navigation hints for keyboard users are provided using
aria-describedby, the text for the usage hint comes from the
USAGE_HINT localization symbol. If an asset has a label defined in the UserData field, the
aria-label attribute is set with the value of such label.
Components that display swatches have the role
aria-label attribute set to the value of the
LABEL localization symbol of that component. Individual swatches have the role
aria-posinset attributes to describe the swatch position in the set. If a swatch is selected, it gets the
aria-selected attribute set to
Slider components have the role
slider with attributes
aria-valuemax to describe the current slider position.