• What is KendoReact
  • Getting Started
  • Unstyled Mode
  • Server Components
  • Components
    • Animation
    • Barcodes
    • Buttons
    • Chart Wizardnew
    • Chartsupdated
    • Common Utilities
    • Conversational UIupdated
    • Data Gridupdated
    • Data Query
    • Data Toolsupdated
    • Date Inputs
    • Date Math
    • Dialogsupdated
    • Drawing
    • Dropdowns
    • Editor
    • Excel Export
    • File Saver
    • Form
    • Gantt
    • Gauges
    • Indicators
    • Inputsupdated
    • Labels
    • Layoutupdated
    • ListBoxupdated
    • ListView
    • Map
    • Notification
    • OrgChart
    • PDF Processing
    • PDF Viewer
    • PivotGrid
    • Popup
    • Progress Bars
    • Ripple
    • Schedulerupdated
    • ScrollView
    • Sortable
    • Spreadsheet
    • TaskBoard
    • Tooltips
    • TreeList
    • TreeViewupdated
    • Upload
  • Sample Applications
  • Styling & Themes
  • Common Features
  • Project Setup
  • Knowledge Base
  • Changelog
  • Updates
  • Troubleshooting

Splitter Accessibility

Out of the box, the Kendo React Splitter provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.

The Splitter is compliant with the Web Content Accessibility Guidelines (WCAG) 2.2 AA standards 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.

Splitter Pane

SelectorAttributeUsage
.k-panerole=groupSets the proper role for the Splitter pane that identifies a set of user interface objects that is not intended to be included in the page's summary or table of contents.

Note: The value of the aria-label attribute of the split-bar elements will be provided to their respective preceding pane element through the API.

SplitBar

SelectorAttributeUsage
.k-splitbarrole=separatorSets the proper role for the Splitter split-bar element.
aria-labelAn accessible name, with aria-label should be included if there is more than one focusable separator. The value is set through the corresponding SplitterPane API.
.k-splitbar-horizontalaria-orientation=verticalWhen a splitbar separates two panes horizontally, its aria-orientation must be explicitly set to 'vertical'.
aria-keyshortcuts=ArrowLeft ArrowRight ArrowUp ArrowDownSets the aria-keyshortcuts attribute value to announce available keyboard shortcuts. Some are omitted for brevity.

Note: Setting the value-now attribute of the separator element is not applicable, as the Splitter is a complex layout component allowing splitting the content into multiple panes across any number and level of nested Splitters and panes, thus announcing a value would not convey any meaningful information. Moreover, there is no specification, or WAI-ARIA recommendation that explains how value should be set in multiple panes scenario. Further information on this complicated scenario could be found in the following WAI-ARIA GitHub issue:

WAI-ARIA Practices on GitHub

Resources

WAI-ARIA specification for separator

MDN reference for the separator role

Section 508

The Splitter is fully compliant with the Section 508 requirements.

Testing

The Splitter 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 Splitter has been tested with the following screen readers and browsers combinations:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

See Also