Marcelo Paiva

Accessibility

Testing the home page with VoiceOver

A first pass at testing this site’s home page with VoiceOver, the screen reader built into the Mac, before testing it with people with disabilities. The goal was to find barriers early and fix them. Each step is a short video, and each problem found is fixed and tested again in the same video.

In brief

The home page works with a keyboard and a screen reader for most of what was tested. It has a skip link, a clear outline of headings, named regions, and controls that say what they are and what state they are in. Focus is always visible, and Escape always puts it back where you were.

The test found six problems on the page. Five are fixed and live, one of them by working around a bug in Safari, and one, a small one, is still open. One more thing heard was VoiceOver and Safari, not the page.

About these videos

Two voices. The tester (af_heart) drives VoiceOver and the keyboard and says what she hears. The reviewer (am_puck) names the guideline a problem falls under, explains why it matters, and says what changed in the code. Both are synthetic voices; the captions label them Tester and Reviewer.

What these videos are. VoiceOver in Safari, on macOS 27, driven by a script so each test can be run again the same way. What you hear from VoiceOver is what it said. The narrator is a synthetic voice, describing what a tester listens for.

What they are not. An audit, or a claim that the site conforms to WCAG. It is one specialist, one screen reader and one browser, on one page. Nobody who uses a screen reader every day took part: that comes next, in the recommendations.

Captions. Every video has captions for both voices on screen. They are also in each video as a captions track, and as a file you can download, with a transcript under each video.

Where they were filmed. On copies of this site built from just before and just after each fix, served from my own Mac. The last check of Describe this page was filmed on the live site.

Overview

The tester and the reviewer introduce themselves and how they split the work, then the goal of the test, why it is a first pass, the six steps, and how each video goes: find, fix, test again.

1 minute 20 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Hello. This is the home page of Marcelo Paiva's site, in Safari, with VoiceOver on. I'm the tester. I'll drive VoiceOver and the keyboard, and tell you what I hear.
  2. Reviewer: And I'm the reviewer. When something sounds wrong, I'll name the guideline it falls under, and explain why it matters to the person it stops. When it's fixed, I'll say what changed in the code.
  3. VoiceOver: Marcelo Paiva — Design Engineer web content is in the VoiceOver cursor
  4. Tester: The goal is simple. Can someone using VoiceOver understand this page, find what they need, and use its controls, without seeing it?
  5. Reviewer: This is a first pass, before testing with people with disabilities. It finds problems early, so they can be fixed, and so the time with people goes on what only they can tell us.
  6. Tester: I test in six steps. First, I inspect the page structure in the code. Second, the keyboard on its own. Third, a reading pass with the screen reader, top to bottom. Fourth, jumping by headings, landmarks and links. Fifth, the controls themselves. And sixth, real tasks, start to finish.
  7. Reviewer: Each step gets its own short video. When we find a problem, we fix it, and test again in the same video. At the end, we list what still needs testing with people.

The six steps

Step 1: the structure, before the screen reader

The goal: understand the intended structure and find obvious semantic problems.

Safari’s Web Inspector, before any screen reader: what the page tells assistive technology. The Set for you button says it is collapsed and which panel it controls. That panel is hidden, but its four dropdowns are still inside it, in the page.

1 minute 15 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Step one, before any screen reader: the structure in the code. I'm opening Safari's Web Inspector, and making it larger, to see what this page tells assistive technology.
  2. Keyboard: Command-Option-I: the Web Inspector
  3. Keyboard: Command-Plus: makes the Inspector larger
  4. Keyboard: Command-Plus: larger again
  5. Keyboard: Command-Option-C: the Console
  6. Keyboard: Command-K: clears the Console
  7. Keyboard: Typed inspect(document.querySelector('button[aria-expanded]'))
  8. Tester: This is the Set for you button. Its attributes say aria-expanded, false, and aria-controls points at the panel it opens.
  9. Reviewer: That's what a screen reader needs. Expanded, false, is announced as collapsed, so the person knows there's more behind it.
  10. Keyboard: Command-Option-C: back to the Console
  11. Keyboard: Command-K: clears the Console
  12. Keyboard: Typed panel = document.getElementById(document.querySelector('button[aria-expanded]').getAttribute('aria-controls'))
  13. Keyboard: Typed [panel.hidden, panel.querySelectorAll('select').length]
  14. Tester: That panel is marked hidden, and the four dropdowns are still inside it, in the page.
  15. Reviewer: Hidden content should stay out of a screen reader's way. Nothing's wrong yet… but it's the first thing to listen for, in the reading pass.
  16. Keyboard: Command-0: the Inspector back to normal size
  17. Keyboard: Command-Option-I: closes the Web Inspector

What it found: Something to listen for, not yet a problem: hidden content should stay out of a screen reader’s way. The reading pass in step 3 hears that it doesn’t.

Step 2: the keyboard on its own

The goal: the page works without a mouse, before the screen reader comes in.

No screen reader and no mouse: real key presses, with the focus ring showing where each one lands. The skip link skips the header, and Shift-Tab retraces it in screen order. Set for you opens with Return; typing “n” in the Drawings dropdown chooses “not at all”, and the drawings go. Escape puts focus back on the button, and Space presses Pause motion.

1 minute 56 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Step two, the keyboard on its own. No screen reader and no mouse, just the keys a keyboard user presses, and the focus ring that shows where I am.
  2. Keyboard: Tab → link, Skip to content
  3. Tester: The first stop is a skip link. I'll press Return, then Tab, to see whether it really skips the header.
  4. Keyboard: Return → main
  5. Keyboard: Tab → link, Read the writing
  6. Tester: I'm on Read the writing, past the whole header. The skip link works.
  7. Reviewer: That's WCAG 2.4.1, Bypass Blocks. Without it, a keyboard user tabs through every link in the header, on every page.
  8. Tester: Now back up, with Shift-Tab.
  9. Keyboard: Shift-Tab → button, Pause motion
  10. Keyboard: Shift-Tab → button, Set for you, collapsed
  11. Tester: Pause motion, then Set for you: the same order as on screen, and the focus ring follows every time.
  12. Reviewer: That's 2.4.7, Focus Visible. If you can't see where focus is, using a keyboard is guesswork.
  13. Tester: I'll open it with Return.
  14. Keyboard: Return → button, Set for you, expanded
  15. Keyboard: Tab → pop-up button, Drawings, in calm color
  16. Tester: It opens, and Tab takes me to the first setting, the drawings. With a dropdown focused, I can type the first letter of a choice. N, for not at all.
  17. Keyboard: Typed n
  18. Keyboard: Focus is on → pop-up button, Drawings, not at all
  19. Tester: The dropdown says not at all, and the drawings are gone. Now Escape.
  20. Keyboard: Escape → button, Set for you, collapsed
  21. Tester: Escape closes the panel, and puts focus back on the button. Next, Pause motion.
  22. Keyboard: Tab → button, Pause motion
  23. Keyboard: Space → button, Pause motion, pressed
  24. Tester: Space presses it, and the button now says pressed.
  25. Reviewer: Tab, Shift-Tab, Return, Escape, Space, and typing to choose. Every control works without a mouse, and focus is never trapped or lost. For what was tested, the goal of step two is met. WCAG 2.1.1, Keyboard, holds here.

What it found: For everything tested here, the page works without a mouse. WCAG 2.1.1 Keyboard and 2.4.7 Focus Visible hold.

Step 3: the reading pass, then the fix

The goal: the experience of discovering and understanding the page.

VoiceOver reads the home page from the top, one item at a time. Just after the Set for you button it says “menu”, four times, and doesn’t move. There is no menu on screen. Then the same steps on the fixed page.

2 minutes 21 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Step three, the reading pass. The home page from the top, in Safari with VoiceOver, the way someone who can't see the screen would meet it.
  2. VoiceOver: Skip to content visited link is in the VoiceOver cursor
  3. Tester: The first thing it reaches is a skip link, which is a good start. Now I'll read the header one item at a time.
  4. VoiceOver: Describe this page dialog pop up button
  5. VoiceOver: banner
  6. VoiceOver: visited link Marcelo Paiva
  7. VoiceOver: Main navigation
  8. VoiceOver: list 5 items
  9. VoiceOver: link Writing 1 of 5
  10. VoiceOver: link Work 2 of 5
  11. VoiceOver: link Signal 3 of 5
  12. VoiceOver: link Tools 4 of 5
  13. VoiceOver: link Resume 5 of 5
  14. VoiceOver: end of list
  15. VoiceOver: end of Main navigation
  16. VoiceOver: Set for you collapsed button
  17. Tester: Set for you… a button, and it tells me it's collapsed. That's what I want to hear. Next item.
  18. Reviewer: A name, a role, and a state. That's what WCAG 4.1.2 asks for.
  19. VoiceOver: menu
  20. VoiceOver: menu
  21. VoiceOver: menu
  22. VoiceOver: menu
  23. Tester: It says menu… and again… and again. Four presses, and it hasn't moved past it.
  24. Reviewer: There's no menu on screen. The settings panel is closed, but its four dropdowns are still reaching VoiceOver. That's a problem under WCAG 4.1.2, Name, Role, Value. If you're listening, it sounds like the page has stopped, right at the control that sets the site up for you.
  25. Reviewer: The fix: the panel is now left empty while it's closed. Here's the same page after that change.
  26. Tester: I'll go straight to Set for you.
  27. VoiceOver: Set for you collapsed button
  28. Tester: Collapsed, the same as before. Next item.
  29. VoiceOver: Pause motion toggle button
  30. Tester: That's Pause motion, the next button on the screen. The silence is gone.
  31. Reviewer: 4.1.2 holds here.

What it found: A problem under WCAG 4.1.2 Name, Role, Value, fixed: the panel is now empty while it is closed, and VoiceOver goes from Set for you straight to the next button. WCAG 4.1.2 holds.

Step 4: structural navigation, then the fix

The goal: finding information without reading the whole page.

Jumping by headings, landmarks and links instead of reading everything. The heading outline holds and every landmark has a name. In the drawing strip, each link reads its essay’s title twice, then the whole summary, and Safari leaves focus rings behind on links already passed. Then the same links on the fixed page.

3 minutes 43 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Step four, structural navigation. Someone using a screen reader rarely reads every item. They jump, by headings, by landmarks, and by links. First, headings.
  2. VoiceOver: heading level 1 I design experiences and ship accessible code that runs them.
  3. VoiceOver: heading level 2 LATEST WRITING
  4. VoiceOver: Last heading heading level 2 LATEST WRITING
  5. VoiceOver: heading level 3 link Designers don't need Figma anymore
  6. Tester: One level one, a level two for the latest writing, and the essays under it at level three. The outline holds, all the way down.
  7. Reviewer: That's WCAG 1.3.1, Info and Relationships. Headings are how someone using a screen reader skims a page.
  8. Tester: Now landmarks.
  9. VoiceOver: banner visited link Marcelo Paiva
  10. VoiceOver: Last landmark banner
  11. VoiceOver: Main navigation
  12. VoiceOver: main MARCELO PAIVA group
  13. VoiceOver: More essays, by their drawings region
  14. VoiceOver: LATEST WRITING region
  15. Tester: Each region is announced with a name, so I can tell them apart and jump straight to the one I want.
  16. Tester: And links. In a list of links, each one has to make sense on its own.
  17. VoiceOver: Marcelo Paiva visited link
  18. VoiceOver: Writing link
  19. VoiceOver: Work link
  20. VoiceOver: Signal link
  21. VoiceOver: Tools link
  22. VoiceOver: Resume link
  23. VoiceOver: Read the writing link
  24. VoiceOver: See the work link
  25. VoiceOver: How do you keep something powerful approachable? link
  26. VoiceOver: How do we learn a spec nobody reads? How do we learn a spec nobody reads? Nobody learns a language by reading its dictionary, and I think that explains most of what is wrong with how we teach accessibility. link
  27. VoiceOver: Last link How do we learn a spec nobody reads? How do we learn a spec nobody reads? Nobody learns a language by reading its dictionary, and I think that explains most of what is wrong with how we teach accessibility. link
  28. Tester: The essays in the drawing strip read their title twice, and then the whole summary.
  29. Reviewer: Each link still makes sense, so WCAG 2.4.4 is met. But a list of links is how people scan a page, and this one takes several seconds per link. It's worth fixing.
  30. Tester: Something else, on screen. As I moved through the links, rings stayed behind on links I'd already left. Even now, See the work still has one, though I'm in the drawing strip.
  31. Reviewer: That's WCAG 2.4.7, Focus Visible. Someone who sees the screen while using VoiceOver, or a person sitting beside them, needs to find focus at a glance. The page's styles are right: this is a bug in Safari. But people still see it, so the page works around it.
  32. Reviewer: Two fixes. Each link is now described by its summary alone, and a small script makes Safari redraw whatever just lost focus. Here's the same list after both changes.
  33. VoiceOver: Last link Skip to content link
  34. VoiceOver: Marcelo Paiva visited link
  35. VoiceOver: Writing link
  36. VoiceOver: Work link
  37. VoiceOver: Last link Work link
  38. VoiceOver: Signal link
  39. VoiceOver: Tools link
  40. VoiceOver: Resume link
  41. VoiceOver: Read the writing link
  42. VoiceOver: See the work link
  43. VoiceOver: How do you keep something powerful approachable? link
  44. VoiceOver: How do we learn a spec nobody reads? Nobody learns a language by reading its dictionary, and I think that explains most of what is wrong with how we teach accessibility. link
  45. VoiceOver: Should a design system have a file written for machines? Writing rules for a reader who cannot ask a follow-up question turned out to be the clearest thinking I have done about my own design system. link
  46. Tester: Now each essay says its title once, then its summary, and only the link I'm on has a ring.

What it found: Headings: WCAG 1.3.1 holds. Links: WCAG 2.4.4 is met, but the doubled titles made the list slow to get through. Focus: stale rings fail WCAG 2.4.7 on screen; the cause is a Safari bug. Fixed: each link now says its title once, then its summary, and only the current link has a ring.

Step 5: the Set for you control

The goal: controls are understandable and usable, not merely discoverable.

The settings button, closely: its name, role and state, what happens when it opens, each setting inside it, and where Escape leaves you.

1 minute 36 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Step five, the controls. Finding Set for you isn't enough. It has to say what it is, what state it's in, and work from the keyboard.
  2. VoiceOver: Set for you collapsed button
  3. Tester: Set for you, a button, collapsed.
  4. Reviewer: Name, role and state, all three. That's WCAG 4.1.2.
  5. VoiceOver: Set for you expanded button
  6. Tester: When I press it, the state changes to expanded, and VoiceOver says so. Now the panel, one item at a time.
  7. VoiceOver: THIS SITE, SET FOR YOU group
  8. VoiceOver: THIS SITE, SET FOR YOU
  9. VoiceOver: Show the drawings
  10. VoiceOver: in calm color Drawings Drawings collapsed pop up button, group
  11. VoiceOver: , with the theme
  12. VoiceOver: following my device Theme collapsed pop up button, group
  13. VoiceOver: , and motion
  14. VoiceOver: allowed Motion collapsed pop up button, group
  15. VoiceOver: . The home page as
  16. VoiceOver: a list of essays Home page collapsed pop up button, group
  17. Tester: The settings read as a sentence, and each dropdown has its own name… Drawings, Theme, Motion, Home page… with its current value first.
  18. VoiceOver: Set for you collapsed button banner
  19. Tester: And Escape closes it, and puts me back on the button, collapsed again.
  20. Reviewer: Focus isn't lost. Where focus goes when a panel or a dialog closes is one of the most common keyboard problems, and here it's right.

What it found: WCAG 4.1.2 holds: the button says collapsed and expanded, every dropdown has a name and says its value, and Escape puts focus back on the button.

Step 6: a real task, then the fix

The goal: people can complete what they came to do.

Turning the drawings off with VoiceOver, start to finish. It works: the drawings go, for VoiceOver too. But nothing says so: the note that confirms it is only on screen. Then the same task on the fixed version, where the change is announced.

3 minutes 20 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Tester: Step six, a real task. I'll turn the drawings off, start to finish, with VoiceOver… and find out whether it tells me it worked.
  2. VoiceOver: Set for you collapsed button
  3. VoiceOver: Set for you expanded button
  4. VoiceOver: THIS SITE, SET FOR YOU group
  5. VoiceOver: THIS SITE, SET FOR YOU
  6. VoiceOver: Show the drawings
  7. VoiceOver: in calm color Drawings collapsed pop up button, group
  8. Tester: There's the Drawings dropdown, set to calm color. I'll open it, and choose not at all.
  9. VoiceOver: menu 3 items ✓ in calm color
  10. VoiceOver: in full color
  11. VoiceOver: not at all
  12. VoiceOver: in calm color Drawings Drawings collapsed pop up button, group
  13. Tester: When I choose it, VoiceOver reads the old value… calm color.
  14. Reviewer: That seems to be VoiceOver in Safari, with a standard dropdown. It isn't the page.
  15. Tester: I'll ask again to hear what's set.
  16. VoiceOver: not at all Drawings collapsed pop up button, group is in the VoiceOver cursor
  17. Tester: Not at all. It worked… but nothing told me. The panel has a note about it, so I'll go and find it.
  18. VoiceOver: , with the theme
  19. VoiceOver: following my device Theme collapsed pop up button, group
  20. VoiceOver: , and motion
  21. VoiceOver: allowed Motion collapsed pop up button, group
  22. VoiceOver: . The home page as
  23. VoiceOver: a list of essays Home page collapsed pop up button, group
  24. VoiceOver: .
  25. VoiceOver: end of THIS SITE, SET FOR YOU group
  26. VoiceOver: Your device is set to dark, so this site is too. Drawings are off, and their captions go with them. Nothing else on a page depends on them.
  27. Tester: There it is. Drawings are off, and their captions go with them.
  28. Reviewer: That's a status message, and it's only on screen: it should be announced, without going to look. That's a problem under WCAG 4.1.3, Status Messages. Someone listening can't tell whether their choice worked.
  29. VoiceOver: Set for you collapsed button
  30. VoiceOver: link See the work
  31. VoiceOver: LATEST WRITING region
  32. Tester: And after See the work, VoiceOver goes straight to Latest writing. The drawings are gone for a listener too.
  33. Reviewer: The fix: a status line that says what each change did. Here's the same task on the fixed version, the one that's live now.
  34. VoiceOver: Set for you collapsed button
  35. VoiceOver: Set for you expanded button
  36. VoiceOver: THIS SITE, SET FOR YOU group
  37. VoiceOver: THIS SITE, SET FOR YOU
  38. VoiceOver: Show the drawings
  39. VoiceOver: in calm color Drawings collapsed pop up button
  40. VoiceOver: menu 3 items ✓ in calm color
  41. VoiceOver: in full color
  42. VoiceOver: not at all
  43. VoiceOver: in calm color Drawings Drawings collapsed pop up button, Drawings are off and their captions go with them.
  44. Tester: There it is: drawings are off, and their captions go with them, said straight after the choice.
  45. Reviewer: 4.1.3 holds here.

What it found: A problem under WCAG 4.1.3 Status Messages, fixed: VoiceOver now says “Drawings are off and their captions go with them.” straight after the choice. WCAG 4.1.3 holds.

Extra: Describe this page, then the fix

A screen reader reads a page in a line, one item at a time; it doesn’t say what the page looks like. Describe this page puts the layout into words, so someone who is blind gets a map: what is on the page before reading all of it, and where things are when a sighted colleague points to “the column on the right”.

2 minutes 26 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Reviewer: One more feature to test: Describe this page. A screen reader reads a page one item at a time, in a line. It doesn't say that the essays fill most of the page, or that a narrow column sits beside them.
  2. Reviewer: For someone who's blind, a picture of the layout is a map. It says what's on the page before reading all of it, and where things are when a sighted colleague says it's in the column on the right.
  3. VoiceOver: system has new window
  4. VoiceOver: Describe this page dialog pop up button
  5. Tester: It's the second thing on the page, right after the skip link. I'll press it.
  6. VoiceOver: The home page web dialog with 9 items heading level 2 The home page
  7. Tester: It says the dialog's name, The home page, and its heading… and stops there. The picture of the page isn't read until I go looking.
  8. VoiceOver: Close button
  9. VoiceOver: This is the front page of a magazine. The newest essays take most of the page, and a narrower column beside them lists everything else.
  10. VoiceOver: heading level 3 From top to bottom
  11. VoiceOver: list 7 items
  12. VoiceOver: 1
  13. VoiceOver: At the top, the site header: my name, which goes home, then links to Writing, Work, Signal, Tools and Resume, then Set for you, where you choose the drawings, theme and motion. Beside it is a button that pauses everything that moves.
  14. Tester: It starts with a picture: the front page of a magazine, the newest essays taking most of the page, and a narrower column beside them. Then it walks the layout from top to bottom.
  15. Reviewer: What it says is useful. But on opening it only says its name, so someone has to explore to find out what the page is like. That's not a guideline failure, but it holds back the whole point of the feature.
  16. VoiceOver: At the top, the site header: my name, which goes home, then links to Writing, Work, Signal, Tools and Resume, then Set for you, where you choose the drawings, theme and motion. Beside it is a button that pauses everything that moves.
  17. Reviewer: The fix, now live: the heading carries the description, so it's read the moment the dialog opens. Same steps, on the live site.
  18. VoiceOver: link Skip to content
  19. VoiceOver: Describe this page dialog pop up button
  20. VoiceOver: The home page web dialog with 9 items heading level 2 The home page This is the front page of a magazine. The newest essays take most of the page, and a narrower column beside them lists everything else.
  21. Tester: This time it reads the picture straight away: the front page of a magazine, the newest essays taking most of the page.
  22. Reviewer: Now the feature does its job from the first second. Whether the description helps is for blind people to tell us.
  23. VoiceOver: Describe this page dialog pop up button

What it found: The description works, but on opening VoiceOver read only its name and heading. Fixed: on the live site, it reads the picture of the page straight away.

What needs testing with people with disabilities

A screen reader run by script shows whether things work. It cannot show whether they are good to use. These are the areas where only the people they are for can say.

The recommendations, on screen

Each area that needs testing with people with disabilities, shown on the page as it is named: the Describe this page dialog, the Set for you sentence, the moving drawings, the page zoomed in, and the Home page setting that switches to the collage.

3 minutes 52 seconds. The captions are part of the picture. Download the captions.
Read the transcript
  1. Reviewer: Last, what this first pass can't tell us. A screen reader shows whether things work as built, not whether they help the people they're for. These need people with disabilities, on their own devices and settings. I'll show each one on the page as we name it.
  2. Tester: First, Describe this page. I'll press Tab twice, to its button in the skip links, then Return to open it.
  3. Keyboard: Tab → link, Skip to content
  4. Keyboard: Tab → button, Describe this page
  5. Keyboard: Return → heading, The home page
  6. Tester: A dialog sits over the dimmed page, titled The home page: one sentence comparing it to the front page of a magazine, then a numbered list of its parts, top to bottom, and a Close button at the top. Does a description like this help someone picture the page? Is it too long, or too short? Blind people who use a screen reader every day should tell us, on VoiceOver and on JAWS or NVDA.
  7. Tester: I'll press Escape to close it.
  8. Keyboard: Escape → button, Describe this page
  9. Reviewer: Second, other screen readers and devices. We're back on the home page. This pass used VoiceOver in Safari only, and its biggest finding came from how Safari passes hidden content to VoiceOver. JAWS, NVDA, VoiceOver on iPhone and TalkBack all behave differently.
  10. Tester: Third, Set for you. I'll Tab across the header: my name, Writing, Work, Signal, Tools and Resume, then Set for you, and press Return to open it.
  11. Keyboard: Tab → link, Marcelo Paiva
  12. Keyboard: Tab → link, Writing
  13. Keyboard: Tab → link, Work
  14. Keyboard: Tab → link, Signal
  15. Keyboard: Tab → link, Tools
  16. Keyboard: Tab → link, Resume
  17. Keyboard: Tab → button, Set for you, collapsed
  18. Keyboard: Return → button, Set for you, expanded
  19. Tester: A small panel drops down with one sentence: show the drawings in calm color, with the theme following my device, and motion allowed. The home page as a list of essays. Each of those choices is a dropdown. Whether a sentence like that feels natural, and whether the announcements are enough, is for screen reader users, and people with cognitive or learning disabilities, to say.
  20. Tester: Escape closes the panel.
  21. Keyboard: Escape → button, Set for you, collapsed
  22. Reviewer: Fourth, motion. Under the introduction, a band of drawings drifts slowly sideways, and thin lines and points move across the dark background behind the heading. A pause button sits beside Set for you. It works… but is it found in time, and is the motion comfortable before it is? People with vestibular disorders can tell us.
  23. Tester: Fifth, zoom and magnification. I'll zoom in, pressing Command-Plus three times.
  24. Keyboard: Command-Plus: zooms the page
  25. Keyboard: Command-Plus: zooms the page
  26. Keyboard: Command-Plus: zooms the page
  27. Tester: The heading now fills most of the width, the header stays across the top, and the text sits over the moving background. People with low vision who use zoom or a screen magnifier should try it.
  28. Tester: Command-Zero puts the page back to its normal size.
  29. Keyboard: Command-0: back to actual size
  30. Reviewer: Sixth, voice control and switch access. Names were checked for what a screen reader says, not for what people say aloud, and the home page has more than fifty stops for someone moving one step at a time.
  31. Tester: And last, the collage. I'll press Return to open Set for you again, then Tab past Drawings, Theme and Motion, to its last dropdown.
  32. Keyboard: Return → button, Set for you, expanded
  33. Keyboard: Tab → pop-up button, Drawings, in calm color
  34. Keyboard: Tab → pop-up button, Theme, following my device
  35. Keyboard: Tab → pop-up button, Motion, allowed
  36. Keyboard: Tab → pop-up button, Home page, a list of essays
  37. Keyboard: Focus is on → pop-up button, Home page, a list of essays
  38. Tester: The Home page dropdown reads a list of essays. Choosing a collage of drawings there turns the home page into a field of pictures. This pass tested the list only.
  39. Tester: Escape closes it.
  40. Keyboard: Escape → button, Set for you, collapsed
  41. Tester: That's the end of the first pass. Six problems found on the page: five fixed and live, and one still open.
  42. Reviewer: The next test is with people.

Testing the home page with VoiceOver

This is a test report with its films. It reads top to bottom, a short summary first, then one video for each step of the test.

From top to bottom

  1. At the top, the site header: my name, which goes home, then links to Writing, Work, Signal, Tools and Resume, then Settings, where you choose the drawings, light or dark, and movement.
  2. A link back to Accessibility, the heading, and a paragraph on what the test was: a first pass with VoiceOver, before testing with people with disabilities.
  3. In brief: two paragraphs, then each problem found, one to a box, starting with whether it is fixed, open, or not the page at all.
  4. About these videos: who the two voices are, what the videos are and are not, the captions, and where they were filmed.
  5. The overview video, then The six steps, one video each, and a seventh on Describe this page. Each video has a goal above it and a transcript below it.
  6. What needs testing with people with disabilities: seven areas, each with who to test it with, then a video showing them on the page.
  7. At the bottom, the footer: a note on how this site is built, links to Illustrations, Pens, Concepts and Accessibility, this Describe this page button, then GitHub, LinkedIn and email.

What you can do here

Watch or read how the home page did with a screen reader, and what is still to test.

Also here

Every video has its captions drawn in, a captions file to download, and a full transcript that says who is speaking.