Accessibility in Blazor Maps Component
11 Apr 20223 minutes to read
Maps provides built-in compliance with the WAI-ARIA specifications. The WAI-ARIA accessibility support is achieved through the attribute like aria-label
in the SVG element. It helps to provide information about elements in a document for assistive technology. This attribute sets the text label with some default description for the following elements in Maps.
Element | Default description |
Maps container | Specifies the Maps component. |
Maps title | Specifies the title of the Maps. |
Maps subtitle | Specifies the sub-title of the Maps. |
Legend title | Specifies the title of legend in the Maps. |
To change this default description, use the Description
property available in MapsLegendTitle
, MapsTitleSettings
, MapsSubtitleSettings
and SfMaps
. It helps the screen reader to read for an assistive purpose.
Keyboard Navigation
All the Maps actions can be controlled via keyboard keys. The applicable key combinations and their relative functionalities are listed below for the appropriate UI features available in the component.
Interaction Keys | Description |
---|---|
Tab | Moves to the next focusable element on the map, such as the legend or shape. |
Shift + Tab | Moves to the previous focusable element on the map, such as the legend or shape. |
+ | When zooming is enabled, zoom in operation can be performed. |
- | When zooming is enabled, zoom out operation can be performed. |
Left arrow | When zoomed in, the map can be scrolled to the left. |
Right arrow | When zoomed in, the map can be scrolled to the right. |
Up arrow | When zoomed in, the map can be scrolled upward. |
Down arrow | When zoomed in, the map can be scrolled downward. |
R | When zooming is enabled, reset operation can be performed. |
Enter | The page can be navigated to the next and previous states in legend. Similarly, the selection can be made while navigating over the shape. |