Viewing Turtl Docs
All Turtl Docs have an accessible version that is compliant with ADA and WCAG 2.1 AA regulations.
This accessible version is mainly used by screen readers. When a screen reader arrives on a Turtl Doc the first thing it reads is "Press enter to view the accessible version of this page". You can view this accessible version as well by adding "?accessible" to the end of the Doc URL. For example:
There is one exception to this rule. If the doc is a Personalized, the URL structure changes which adds a '?' into the URL. This means adding another one will not work, instead you will need to add '&'
To sum it up:
If there is already '?' in the URL you will need to add '&accessible' at the end of the doc
If there is no '?' in the URL you will need to add '?accessible' at the end of the doc.
Check out this guide to accessibility on Turtl
Turtl Docs are also navigable using only the tab and enter keys. Try this yourself by opening a Doc and pressing tab, you'll be able to see the different buttons highlight as you tab through the page and pressing enter will work the same as clicking on them.
When editing Docs, you can also use keyboard shortcuts to aid accessibility. Remind yourself of these shortcuts at any time by pressing Alt+0 while in the Doc editor.
Here's a list of all the shortcuts available:
Press Alt+F10 to navigate to the toolbar. Move to the next and previous toolbar group with tab and shift+tab. Move to the next and previous toolbar button with the right arrow or left arrow. Press space or enter to activate the toolbar button.
Inside a dialog, press tab to navigate to the next dialog element, press shift+tab to move to the previous dialog element, press enter to submit the dialog, press esc to cancel the dialog. When a dialog has multiple tabs, the tab list can be reached either with alt+F10 or with tab as part of the dialog tabbing order. With tab list focused, move to the next and previous tab with right and left arrow, respectively.
Editor Context Menu
Press Shift+F10 or application key to open context-menu. Then move to the next menu option with tab or down arrow. Move to previous option with shift+tab or up arrow. Press space or enter to select the menu option. Open sub-menu of current option with space or enter or right arrow. Go back to the parent menu item with esc or left arrow. Close context menu with esc.
Editor List Box
Inside a list-box, move to the next list item with tab or down arrow. Move to previous list item with shift+tab or up arrow. Press space or enter to select the list option. Press esc to close the list-box.
Paste as plain text
Creating Accessible Docs
Alternative text for media accessibility
Alt text is text added within a webpage to describe the appearance and function of media such as images, charts and videos. It is important to add alt text for a few reasons, one being that if the media fails to load then this text will be displayed instead, and another being that this will be the text read out to visually impaired or other readers using screen-readers.
To add alt text to your Surf image or video, click the three dots underneath the “media” section.
This will open the “Media settings” box where you can enter your description of the image or video.
To add alt text to media in the Immerse sections of your Turtl Doc, open the media settings and navigate to the "misc" tab.
Here are some key tips for writing alternative text in your Turtl Docs:
Make sure your text is sufficiently descriptive. If you couldn’t see the image, what description would be helpful to you to get an accurate idea of what the media is trying to portray?
Make sure the alt text is no longer than 125 characters to make sure it doesn’t get cut off by screen-readers
Don’t start your alt text with "image of", "photo of" etc. There’s no need since screen-readers can see what type of media it is from the source code of the webpage
Order of Immerse content for accessibility
It’s important to keep in mind the order of your Immerse content in the editor to ensure it flows correctly for screen readers and when using the keyboard tab button for navigation. The easiest way to see how your Immerse content flows is by checking your Turtl Doc in mobile view. The order reflected in the mobile view is the same order that will be used for accessibility purposes.
You can see how your Turtl Doc looks on mobile by clicking the mobile preview button in the top right of the editor.
Learn more about how to edit the mobile view of your Turtl Doc here.