@progress/wct-a11y-spec
Version:
Contains accessibility and keyboard navigation specification of Telerik and Kendo web components.
44 lines (23 loc) • 1.79 kB
Markdown
The Kendo UI for jQuery Editor component is [WCAG 2.1 AAA](https://www.w3.org/TR/WCAG21/) and [Section 508](http://www.section508.gov/) compliant. The component also follows the [WAI-ARIA best practices](https://www.w3.org/WAI/ARIA/apg/) for implementing the keyboard navigation for its component role, and is tested against the popular screen readers.
## Wai-Aria
The Editor component has two distinctive modes - one with `<textarea>` and an `<iframe>` containing an HTML document and another one with only a contenteditable `<div>` (Inline Editor). The inline mode of the Editor does not require any particular ARIA attributes to be present in the widget.
### Editor with textarea
| Selector | Attribute | Usage |
| -------- | --------- | ----- |
| .k-iframe | `tabindex=0` | The element must be part of the page tabsequence. |
| | `label for=` or `aria-label` or `aria-labelledby` | The component focusable element needs an accessible name to be assigned to it. |
### Editor with contenteditable div
When in its inline mode (with a contenteditable `div` element), the editor does not represent a form input. Hence, no additional attributes are required in that scenario.
## Resources
[WAI-ARIA specification for textbox](https://www.w3.org/TR/wai-aria-1.2/#textbox)
## Section 508
The Editor is compliant with the [Section 508](http://www.section508.gov/) requirements
## Testing
The component has been extensively tested automatically with static code analyzers and manually with the most popular screen readers.
> Any Accessibility Issues could be reported in [Telerik Support System](https://www.telerik.com/account/support-center).
### Screen Readers
| Environment | Tool |
| ----------- | ---- |
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |