Accessibility in Syncfusion® Blazor SfPdfViewer components

5 May 20259 minutes to read

The Blazor SfPdfViewer component followed the accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles that are commonly used to evaluate accessibility.

The accessibility compliance for the Blazor SfPdfViewer component is outlined below.

Accessibility Criteria Compatibility
WCAG 2.2 Support Yes
Section 508 Support Yes
Screen Reader Support Yes
Right-To-Left Support Yes
Color Contrast Yes
Mobile Device Support Intermediate
Keyboard Navigation Support Yes
Axe-core Accessibility Validation Yes
Yes - All features of the component meet the requirement.
Intermediate - Some features of the component do not meet the requirement.
No - The component does not meet the requirement.

WAI-ARIA attributes

WAI-ARIA (Accessibility Initiative – Accessible Rich Internet Applications) defines a way to increase the accessibility of web pages, dynamic content, and user interface components developed with Ajax, HTML, JavaScript,and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components. The following ARIA attributes are used in the Blazor SfPdfViewer component:

Attributes Purpose
aria-disabled Indicates whether the Blazor SfPdfViewer component is in a disabled state or not.
aria-expanded Indicates whether the suggestion list has expanded or not.
aria-readonly Indicates the readonly state of the Blazor SfPdfViewer element.
aria-haspopup Indicates whether the Blazor SfPdfViewer input element has a suggestion list or not.
aria-label Indicates the breadcrumb item text.
aria-labelledby Provides a label for the SfPdfViewer. Typically, the “aria-labelledby” attribute will contain the id of the element used as the Blazor SfPdfViewer’s title.
aria-describedby This attribute points to the Blazor SfPdfViewer element describing the one it’s set on.
aria-orientation Indicates whether the Blazor SfPdfViewer element is oriented horizontally or vertically.
aria-valuetext Returns the current text of the SfPdfViewer.
aria-valuemax Indicates the Maximum value of the SfPdfViewer.
aria-valuemin Indicates the Minimum value of the SfPdfViewer.
aria-valuenow Indicates the current value of the SfPdfViewer.
aria-controls Attribute is set to the button and it points to the corresponding content.

Keyboard interaction

The Blazor SfPdfViewer component followed the keyboard interaction guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the Message component.

Windows Mac Actions
    Shortcuts for page navigation
Ctrl + / Ctrl</ + + or + Navigate to the first page
Ctrl + / Ctrl</ + + or + Navigate to the last page
/ + Space Navigate to the previous page
/ Space Navigate to the next page
Ctrl + G + G Go To The Page
Scroll up
Scroll down
    Shortcuts for Zooming
Ctrl + = + = Perform zoom-in operation
Ctrl + - + - Perform zoom-out operation
Ctrl + 0 + 0 Retain the zoom level to 1
    Shortcut for Text Search
Ctrl + F + F Open the search toolbar
    Shortcut for Text Selection
Ctrl + C + C Copy the selected text or annotation
Ctrl + X + X Cut the selected text or annotation
Ctrl + V + V Paste the selected text or annotation
    Shortcuts for the general operation
Ctrl + Z + Z Undo the action
Ctrl + Y + Y Redo the action
Ctrl + P + P Print the document
Delete Delete Delete the annotations
Ctrl + Shift + A + + A Toggle Annotation Toolbar
Ctrl + Alt + 0 + + 0 Show Command panel
Ctrl + Alt + 2 + + 2 Show Bookmarks
Ctrl + Alt + 1 + + 1 Show Thumbnails
Ctrl + S + S Download
Shift + H + H Enable pan mode
Shift + V + V Enable text selection mode

Ensuring accessibility

The Blazor SfPdfViewer component’s accessibility levels are ensured through an axe-core with playwright tests.

The accessibility compliance of the Blazor SfPdfViewer component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Blazor SfPdfViewer component with accessibility tools.

See also