Blazor Filter Accessibility
Out of the box, the Telerik UI for Blazor Filter provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The Filter is compliant with the Web Content Accessibility Guidelines (WCAG) 2.1 AA standards](https://www.w3.org/TR/WCAG21/) and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation for its component role, provides options for managing its focus and is tested against the most popular screen readers.
WAI-ARIA
This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.
The Filter component represents visually the structure of a filter object. As the filter object can contain nested objects, that hierarchical structure must be represented in the accessibility tree by the role=tree assigned to the component.
| Selector | Attribute | Usage |
|---|---|---|
.k-filter-container |
role=tree |
Describes the hierarchical structure of the Filter component. |
aria-label |
Specifies a label for the Filter component. | |
.k-filter-group-main,.k-filter-item |
role=treeitem |
Each FilterGroup and FilterExpression represent a separate treeitem in the Filter component structure. |
.k-filter-lines |
role=group |
Represents a group if items in the Filter component. |
.k-toolbar |
role=toolbar |
The role represents a collection of tools. |
aria-label |
Specifies a label for the toolbar. |
Each toolbar in the Filter should follow the specification for a ToolBar component. The elements inside the FilterGroup follow the ARIA specification applicable to their specific roles.
Resources
WAI-ARIA specification for toolbar
Section 508
The Filter is fully compliant with the Section 508 requirements.
Testing
The Filter has been extensively tested automatically with axe-core and manually with the most popular screen readers.
To report any accessibility issues, contact the team through the Telerik Support System.
Screen Readers
The Filter has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |