tiptap/docs/guide/accessibility.md
Philipp Kühn 569aa15c4f Merge branch 'main' of https://github.com/ueberdosis/tiptap into docs/remove-gridsome
# Conflicts:
#	docs/experiments/collaboration-annotation.md
#	docs/experiments/global-drag-handle.md
2021-09-17 23:45:04 +02:00

2.5 KiB
Raw Blame History

tableOfContents
true

Accessibility

:::pro Fund the development ♥ We need your support to maintain, update, support and develop tiptap. If youre waiting for progress here, become a sponsor and fund our work. :::

Introduction

We strive to make tiptap accessible to everyone, but to be honest, theres not much work done now. From our current understanding, thats what needs to be done:

Interface

An interface needs to have well-defined contrasts, big enough click areas, semantic markup, must be keyboard accessible and well documented. Currently, we dont even provide an interface, so for now thats totally up to you.

But no worries, well provide an interface soon and take accessibility into account early on.

Output

The editor needs to produce semantic markup, must be keyboard accessible and well documented. The tiptap content is well structured so thats a good foundation already. That said, we can add support and encourage the usage of additional attributes, for example the Alt-attribute for images.

Writing assistance (optional)

An optional writing assitance could help people writing content semanticly correct, for example pointing out an incorrect usage of heading levels. With that kind of assistance provided by the core developers, we could help to improve the content of a lot of applications.

Resources

Document Section Heading
WCAG 3.0 7.1 Text Alternatives
WCAG 2.1 1.1.1 Non-text Content
WCAG 2.1 2.1 Keyboard Accessible
WCAG 2.1 2.1.1 Keyboard
WCAG 2.1 4.1.1 Parsing
WCAG 2.1 4.1.2 Name, Role, Value
WCAG 2.1 2.1.2 No Keyboard Trap

TODO: Update resources to point to WCAG 3.0 https://www.w3.org/TR/wcag-3.0/

Anything we should add here? Please let us know, so we can take it into account.