Back to Devexpress

Accessibility for Blazor Report Viewer (Native)

xtrareports-404931-web-reporting-common-features-accessibility-report-viewer-blazor-server-accessibility.md

latest6.5 KB
Original Source

Accessibility for Blazor Report Viewer (Native)

  • Jul 03, 2025
  • 5 minutes to read

Accessibility features help users who have a physical disability, such as restricted mobility or limited vision, to use information technology products. This article describes accessibility areas that we take into consideration when developing the DevExpress Blazor Report Viewer (Native).

The DevExpress Blazor Report Viewer (Native) takes into account accessibility guidelines such as WCAG 2.2 (Level AA), Section 508, and EN 301 549 standards. To learn more about how the DevExpress Blazor Report Viewer (Native) satisfies these requirements, refer to the following DevExpress Accessibility Conformance Report (ACR):

Download: Blazor Report Viewer ACR (Jan 2025)

Accessibility Features Overview

Accessibility RequirementSupport Level
Keyboard Navigation Support
Screen Reader Support
Contrast Color Theme
Lighthouse Accessibility Validation
Axe Accessibility Validation
WAVE Accessibility] Validation

- all component features meet the requirement

Accessibility Mode

Accessibility mode for the Blazor Report Viewer component is enabled out-of-the-box.

Screen Reader Support

The Blazor Report Viewer component supports screen readers and complies to WAI-ARIA standards.

For screen readers, you can specify custom text that the screen reader can vocalize instead of element default content. Refer to the AccessibleDescription topic for more details.

Right-to-Left (Does Not Support)

The Blazor Report Viewer component does not support right-to-left mode.

Contrast Color Theme

Some low-contrast themes may not meet the required contrast ratio. Use a high-contrast theme like Blazing Berry or Fluent, or customize a theme to meet the standard.

Review the following help topic for information on DevExpress Blazor styles and themes: Styling and Themes in Blazor.

Keyboard Navigation

Interactive and navigation controls contained in the following UI elements are accessible by keyboard and display a keyboard-focus indicator:

  • Toolbar
  • Document page
  • Drill-trough breadcrumbs
  • Tab Panel
  • Tabs in the Tab Panel: Parameters, Export Options, Search, Document Map, and custom panels.

YouTube video

Toolbar

ActionShortcut Key
Move focus from the browser to the Document Viewer ToolbarTab
Move focus to the next item in toolbarRight Arrow
Move focus to the previous item in toolbarLeft Arrow
Activate the selected toolbar editor
Note : When you select the Search button, the Search Tab is opened and focusedEnter or Space
Open and display a drop-down list or menuAlt + Down Arrow
Move between editor values in the activated Pager or Zoom combo boxUp Arrow, Down Arrow
Deactivate the combo boxEsc

Document Page

ActionShortcut Key
Move focus to the Document Area (or to Drill-Through breadcrumbs if displayed)Tab
Enter Document Read modeEnter or Space
Move between bricks on a pageRight Arrow, Left Arrow
Exit Document Read modeTab, Shift + Tab

Tab Panel

ActionShortcut Key
Move focus to the Tab panelTab
Move between tabs in the Tab panelUp Arrow and Down Arrow
Open or close the selected tabEnter or Space

Preview Parameters Tab

ActionShortcut Key
Move to the next control inside the tabTab
Move to the previous control inside the tabShift + Tab
Activate the parameter editorEnter or Space
Move to the browser toolbar from the last editorTab
Move to the Tab panel from the first editorShift + Tab

Export Options Tab

ActionShortcut Key
Move to the next control inside the tabTab
Move to the previous control inside the tabShift + Tab
Move to the first control inside the tabHome
Move to the last control inside the tabEnd
Open the selected sectionEnter or Space
Toggle the checkbox stateEnter or Space
Display a list of values in a combo boxAlt + Down
Deactivate the editor and move to the next editorTab
Move to the browser toolbar from the last editorTab
Move to the Tab panel from the first editorShift + Tab

Search Tab

ActionShortcut Key
Move to the next control inside the tabTab
Move to the previous control inside the tabShift + Tab
Move to the browser toolbar from the last editorTab
Move to the Tab panel from the first editorShift + Tab
Search a document for the specified textEnter
Navigate to the next search results when the list with the result is selectedDown Arrow
Navigate to the previous search results when the list with the result is selectedUp Arrow
Highlight the matching text in the document
Note : The Search tab remains focused.Enter
Exit the Search result listShift + Tab
Move to the browser toolbar from the last editorTab
Move to the Tab panel from the first editorShift + Tab

Document Map Tab

ActionShortcut Key
Expand the document’s bookmark treeAlt + Right Arrow
Collapse the document’s bookmark treeAlt + Left Arrow
Open the document page that contains the bookmark and highlight the bookmark
Note : The Document Map tab remains focusedEnter
Move to the browser toolbar from the last editorTab
Exit the Document Map Tab and move to the Tab PanelShift + Tab

Common Keyboard Shortcuts

See the following topic for detailed information: Keyboard Shortcuts in the Native Report Viewer.