Accessibility
Open Editor settings, then Accessibility, to adjust screen reader announcements and color vision settings. This page also lists the keyboard controls for using Colletta with a screen reader or only a keyboard.
Automated WCAG 2.2 AA checks cover every main page, panel and dialog, in light and dark and at phone size. A review by hand with VoiceOver is under way. Reviews with NVDA, JAWS and TalkBack, and of the pop-up lists on phones, are planned.
With a screen reader
Section titled “With a screen reader”The text of a document is announced with its view, such as “Document text, Live view”, along with how to leave it and how to find the shortcuts. Inside it:
- headings are read with their level,
- task boxes are named by their words and read as checked or not,
- mentions, dates and links to documents say what they are, including a link whose heading no longer exists,
- formulas are read as math, and diagrams by the title and description their author gave them (see Math and diagrams).
Read details here: Alt+F1
Section titled “Read details here: Alt+F1”Press Alt+F1 (Option+F1 on a Mac) anywhere in the text to hear what’s at the cursor:
- the line number, and what kind of line it is: a heading and its level, a task and whether it’s done, a quote or callout, code and its language, or a table,
- a link and where it leads, a mention’s person or team, or a problem with a link to a document,
- a date in full, with how far away it is,
- who wrote the text, while Who wrote what is on, and who made a change, while Show changes is on,
- how many comment threads are there.
It changes nothing, and it works for everyone, not only in screen reader mode.
Screen reader mode
Section titled “Screen reader mode”Turn on Screen reader mode in Editor settings, under Accessibility. Live view then keeps markdown symbols
such as # and ** visible, so what you hear is exactly what’s in the text. The formatting still shows for anyone
looking at the screen with you.
With screen reader mode on, you can also turn on Announce others’ edits near my cursor. When someone else types or deletes on your line or the lines just above and below it, Colletta says what changed, a moment after they stop.
What’s announced
Section titled “What’s announced”These are read out politely, without moving your focus:
- the connection, once when it’s lost and once when it’s back,
- other people’s new comments and replies in the document you’re in,
- new notifications,
- with Announce who joins and leaves on, when someone opens or leaves the document.
From the keyboard
Section titled “From the keyboard”Everything in Colletta works from the keyboard.
| To | Press |
|---|---|
| leave the text (Tab indents inside it) | Escape, then Tab |
| go to the formatting toolbar | Alt+F10 (Option+F10) |
| see every shortcut | Ctrl+/ (Cmd+/) |
| change the date at the cursor | Ctrl+Alt+Y (Cmd+Option+Y), which opens the calendar |
| tick or untick a task | Ctrl+Enter (Cmd+Enter) |
| open a document or run a command | Ctrl+P or Ctrl+Shift+P (Cmd on a Mac) |
A skip link at the top of each page jumps to the main content, and focus goes back where it was when a dialog closes. The keyboard shortcuts page lists the rest.
Color and color blindness
Section titled “Color and color blindness”Colletta never relies on color alone:
- the connection status has a shape for each state as well as its word,
- the selected comment is underlined twice, and a broken link to a document has a wavy underline,
- the text in Show changes is underlined as well as tinted.
Collaborator colors
Section titled “Collaborator colors”Cursors, avatars and Who wrote what use a set of colors chosen to stay distinct for people with color blindness, and different in lightness too. In any one document, up to seven people never share a color. Each person keeps their usual color unless someone else in the document already has it. Names always show beside cursors.
To make authors differ by more than color, turn on Line styles in “Who wrote what”, or Line styles in the History panel. Each person’s text is then underlined in a style of its own, such as solid, dashed or dotted.
Color vision
Section titled “Color vision”Color vision, in Editor settings under Accessibility, changes the colors that carry meaning: saved and error states, added and removed text, tip and caution callouts, and code colors.
- Red-green safe shows states and callouts in blue and orange instead of green and red, and uses code colors that stay apart for red-green color blindness.
- Blue-yellow safe keeps tip and note callouts apart, uses code colors that stay apart for blue-yellow color blindness, and turns comment highlights and their underline pink instead of yellow.
Code colors change only when Code colors is Default or Soft. High contrast stays as you chose it.
A Preview under the setting shows saved, error, added and removed text, a comment, a highlight, tip and caution callouts and a little code, and changes as you pick a mode.
It only changes your screen. Shapes and words always carry the meaning too, and collaborator colors are color blind safe in every mode.
Motion
Section titled “Motion”When your system asks for reduced motion, Colletta‘s transitions happen at once and the follow-mode highlight stays still. The busy spinner keeps turning, so you can tell something is happening.