Accessibility
Folio can be used with VoiceOver, with the keyboard alone, and with the Mac’s own display settings.
Everything on this page is in Folio today, and each part has a test that fails if it stops working. What isn’t done yet is at the end.
VoiceOver on the page
- VoiceOver reads the script and edits it, the way it reads and edits any text on the Mac.
- When the cursor comes to a new line, VoiceOver says what kind of line it is. For a speech it also says who speaks it: “Dialogue, Maren” or “Parenthetical, Deshawn.” In a treatment or notes it says “Heading, level 1,” “Note” or “Text.”
- When a line becomes another element as you type, VoiceOver says the new one. When you press Return after a name, it says “Dialogue” and the speaker.
- When Folio offers to finish a name, VoiceOver says it: “Suggestion: MAREN.”
- The rotor has Scenes and Characters. Scenes goes from heading to heading and says each scene’s number and heading, as in “Scene 12, INT. LAUNDROMAT - NIGHT.” Characters goes from name to name and says the first words of each speech. In a treatment, Headings goes from heading to heading.
- Bold, italic and underlined words are passed to VoiceOver as the page shows them.
- When a character’s lines are shown or highlighted, VoiceOver says so on each of those lines, with the highlight’s color.
Every part of the window has a name.
- Every button, checkbox, menu, field and color well in Folio’s views, in Notes, Find and Replace, Cast and Voices, and in every section of Settings has a name VoiceOver says. A test walks the whole window the way VoiceOver does and fails on any control without one.
- The parts Folio draws itself give VoiceOver their pieces: the Board’s cards, the Outline, Shape, One Voice, History, Look Up and the Keyboard Shortcuts sheet. Pressing a piece with VoiceOver does what a click does.
- The list of themes in Settings › Appearance says each theme’s name, whether it is light or dark, and whether it is the one in use. You can choose a theme from it.
The keyboard
- Folio’s commands are in its menus, and (⌘K) finds any of them by name.
- (⌘/) lists the keys. They are also on the keyboard shortcuts page.
- The page, the Outline, the Board, Shape, One Voice, Settings and the list of themes all take the keyboard. Folio’s buttons and tabs follow the Mac’s Full Keyboard Access, like the Mac’s own buttons.
- Esc calls off a drag in the Outline and on the Board. In History, ↑ and ↓ choose the scene before or after that changed.
Seeing the screen
- Folio follows the Mac’s Reduce Motion. With it on, nothing glides or fades: each change simply happens.
- Folio follows the Mac’s Increase Contrast. With it on, quieter words and lines move most of the way toward the main text color, in every theme. Words reach 7 to 1 against the window, and edges 3 to 1.
- Every color in every built-in theme is measured against each surface it is drawn on. Words read at 4.5 to 1 or better, and signs and edges at 3 to 1, the levels the web’s accessibility guidelines (WCAG) ask for. A theme you make yourself is kept at 4.5 to 1 or better too. There are two high-contrast themes, one light and one dark. See themes.
- Settings › Appearance › Page text sets the size every script opens at, up to twice the normal size. (⌘=) makes one window larger. The pages and their breaks stay the same at every size.
- Settings › Appearance › Size of menus, sidebar and buttons makes the sidebar, the Outline, the Board and the panels larger.
PDFs a screen reader can follow
- A script exported with is a tagged PDF. A screen reader reads it in the script’s order: the title page, then each scene, with scene headings marked as headings. In dual dialogue it reads the left speech first, then the right.
- Page numbers, (MORE), (CONT’D), scene numbers and revision asterisks are marked as page furniture, so a screen reader passes over them.
- The PDF says which language it is in (the script’s spelling language), and shows the script’s title as its window title.
- The tags change nothing about how the pages look. Folio’s tests compare every page with and without them.
Not done yet.
- Only a script’s PDF is tagged. Treatments, notes and their proofs export as untagged PDFs. Tagging them is on the roadmap.
- Folio’s PDFs don’t yet meet PDF/UA, the formal standard for accessible PDFs, in full. A few small parts are missing, and the result needs checking with a PDF/UA checker before we can claim it.
- Scene numbers aren’t read aloud in a PDF. Each is printed twice, left and right, and a reader would say both.
- Settings’ sliders say their raw number to VoiceOver, instead of the words shown beside them.
- The small panels that open from a click, like the Revisions panel, aren’t yet covered by the test that checks every control has a name.
- With Increase Contrast on, in a few dark and soft themes, some words under a selection read slightly below 4.5 to 1.
- Most of this has been checked by tests. It hasn’t yet been tried by people who use VoiceOver every day.
Tell us about a problem
If something in Folio doesn’t work with the way you use your Mac, write to help@folio.film. Say what you were doing, what happened, and which setting you use, like VoiceOver, Zoom or Full Keyboard Access. A person reads every email.