Accessibility in Syncfusion® Blazor components

22 Oct 202511 minutes to read

All Syncfusion® Blazor components follow WAI-ARIA by default, enabling accessible web applications that are fully navigable with assistive technologies.

Accessibility overview

Accessibility in components refers to designing and building user interface elements so that users with disabilities can perceive, operate, and understand them. Examples include sufficient color contrast, alternative text for images, and keyboard-operable controls and interactions.

Accessibility standards

A component is accessible when it is implemented in accordance with recognized accessibility standards.

The accessibility of the components consists of the following standards and aspects:

ADA - A law to ensure that people with disabilities have the same opportunities and access as people without disabilities.

WCAG 2.2 - Guidelines from the W3C to ensure web content is accessible to people with disabilities, organized by success criteria at levels A, AA, and AAA.

Section 508 - U.S. federal standards for making electronic and information technology accessible, aligned with WCAG.

WAI-ARIA - Roles, states, and properties that enhance accessibility of dynamic web content and applications for assistive technologies.

Keyboard navigation - The ability to use a keyboard to interact with and navigate a user interface.

Syncfusion® Blazor components adhere to these established standards.

Accessibility compliance

Accessibility support in Syncfusion® Blazor components is based on adhering to and applying recognized standards and technical specifications to ensure an intuitive experience for people with disabilities.

There are several methodologies of accessibility validation that can be performed on the Syncfusion® Blazor components, such as:

The WAI-ARIA patterns are followed by the Syncfusion® Blazor components to enable appreciable accessibility.

Each Blazor component is evaluated with manual screen reader testing and automated tests to ensure required attributes and behaviors are present.

Attributes are assigned and updated correctly during interaction. Each component has an appropriate role and ARIA attributes defined by the WCAG 2.2 specification.

In addition to the methodologies mentioned above, Syncfusion® Blazor components are constructed to support the following accessibility aspects.

Screen reader support

Syncfusion® Blazor components follow WAI-ARIA to work properly with screen readers such as Narrator for Windows and VoiceOver for macOS.

Right-to-left support

Right-to-Left (RTL) support allows applications to effectively communicate with users who use languages that are written from right to left, such as Arabic, Hebrew, etc. Syncfusion® Blazor components support the Right-to-Left feature. Refer to the Right-to-Left documentation to learn more about this support.

Color contrast

Syncfusion® Blazor components include predefined themes that provide sufficient color contrast to benefit users with visual impairments.

Mobile device support

Syncfusion® Blazor components are more user-friendly and accessible to individuals using mobile devices, including those with disabilities. These are designed to be responsive, adaptable to various screen sizes and orientations, and touch-friendly.

Keyboard navigation support

Syncfusion® Blazor components support keyboard navigation, allowing users who rely on alternate methods to effortlessly navigate and interact with the component.

Ensuring accessibility

Ensuring the accessibility of Syncfusion® Blazor components is crucial for making the product inclusive and user-friendly for individuals with disabilities. This process involves various types of accessibility testing, including:

  • Automated testing: Accessibility is validated using axe-core with Playwright tests.

  • Manual testing: Manual evaluation using screen readers such as Narrator for Windows and VoiceOver for macOS.

Syncfusion® Blazor components continually improve based on standards updates and user feedback to enhance accessibility.

Accessibility support for specific components

Consult the component-specific documents below for details on how Syncfusion® Blazor components ensure compliance with accessibility standards, including Section 508, WAI-ARIA, WCAG 2.2, keyboard navigation, and more. The table uses the legend shown below.

Components WCAG 2.2 Section 508 Screen Reader Right-To-Left Color Contrast Mobile Device Keyboard Navigation Axe-core Accessibility Validation Accessibility Example Accessibility Documentation
Accordion Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Accumulation Chart Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
AppBar Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
AI AssistView Yes Yes Yes Yes Yes Yes Yes Yes --- Documentation
AutoComplete Intermediate Intermediate Yes Yes Yes Yes Yes Yes Demo Documentation
Breadcrumb Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Bullet Chart Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Button Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Button Group Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Calendar Intermediate Intermediate Yes Yes Yes Yes Yes Yes Demo Documentation
Carousel Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Chart Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
CheckBox Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Blazor Chip Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Circular Gauge Intermediate Intermediate Yes Yes Yes Yes N/A Yes Demo Documentation
Color Picker Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
ComboBox Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
ContextMenu Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Dashboard Intermediate Intermediate Yes Yes Yes Yes N/A Yes Demo Documentation
Grid Intermediate Intermediate Yes Yes Yes Yes Intermediate Intermediate Demo Documentation
DatePicker Intermediate Intermediate Yes Yes Yes Yes Yes Yes Demo Documentation
DateRangePicker Intermediate Intermediate Yes Yes Yes Yes Yes Yes Demo Documentation
Datetime Picker Intermediate Intermediate Yes Yes Yes Yes Yes Yes Demo Documentation
Diagram Intermediate Intermediate Intermediate Intermediate Intermediate Yes Yes Intermediate Demo Documentation
Dialog Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
DocumentEditor Intermediate Intermediate Yes Yes Yes No Intermediate Intermediate Demo Documentation
Dropdown Menu Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
DropDown List Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Dropdown Tree Partial Partial Yes Yes Yes Yes Yes Yes Demo Documentation
FileManager Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
File Upload Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Gantt Chart Partial Yes Partial Yes Yes Yes Yes Yes Demo Documentation
HeatMap Chart Partial Partial Yes N/A Yes Yes N/A Yes Demo Documentation
In-place editor Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Image Editor Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Input Mask Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Kanban Yes Yes Yes Yes Partial Yes Yes Yes Demo Documentation
Linear Gauge Partial Partial Yes N/A Yes Yes N/A Yes Demo Documentation
ListBox Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
ListView Partial Partial Yes Yes Yes Yes Yes Yes Demo Documentation
Maps Yes Yes Yes N/A Yes Yes Yes Yes Demo Documentation
Mention Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Menu Bar Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
MultiSelect Dropdown Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Numeric TextBox Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Pager Partial Partial Yes Yes Yes Yes Yes Yes Demo Documentation
SfPdfViewer Yes Yes Yes Yes Yes Partial Yes Yes Demo Documentation
Pivot Table Partial Partial Yes Yes Yes Yes Partial Partial Demo Documentation
ProgressBar Yes Yes Partial Yes Yes Yes Partial Yes Demo Documentation
ProgressButton Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Query Builder Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
RadioButton Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Range Selector Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Range Slider Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Rating Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Rich Text Editor Yes Yes Yes Yes Partial Yes Yes Yes Demo Documentation
Scheduler Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Sidebar Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Signature Yes Yes Yes N/A Yes Yes Yes Yes Demo Documentation
Skeleton Yes Yes Yes Yes Yes Yes N/A Yes Demo Documentation
Smith Chart Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Sparkline Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
SpeedDial Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
SplitButton Yes Yes Yes N/A Yes Yes Yes Yes Demo Documentation
Splitter Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Stepper Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Stock Chart Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Tabs Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
TextBox Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Timeline Yes Yes N/A Yes Yes Yes N/A Yes Demo Documentation
TimePicker Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Toast Yes Yes Yes Yes Yes Yes N/A Yes Demo Documentation
Toggle Switch Button Yes Yes Yes N/A Yes Yes Yes Yes Demo Documentation
Toolbar Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Tooltip Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
TreeGrid Partial Yes Partial Yes Yes Yes Yes Yes Demo Documentation
TreeMap Partial Partial Yes Yes Yes Yes N/A Yes Demo Documentation
TreeView Yes Yes Yes Yes Yes Yes Yes Yes Demo Documentation
Yes - All features of the component meet the requirement.
Partial - Some features of the component do not meet the requirement.
No - The component does not meet the requirement.