Screen Reader Text

Accessibility Reader Intermediate Nice to Try

Hands-on

Interactive Sandbox

Static partial

Try this

  1. Open page
  2. Interact control
  3. Read result

Assert this

  • Visible elements
  • Text matches
  • Button state toggles

Accessibility / SR-only

Screen Reader Text

Visually hidden helper content.

Hidden hint ready

Hidden helper text for screen readers.

Learning & behavior

User flow

  1. Open page
  2. Interact control
  3. Read result

Learning objectives

  • Pick solid locators
  • Time waits
  • Assert state

Suggested assertions

  • Visible elements
  • Text matches
  • Button state toggles

Selector tips

Good

  • [data-test-id='screen-reader-text-primary']
  • [data-test-id='screen-reader-text-secondary']
  • [data-test-id='screen-reader-text-action']
  • [aria-label='Screen Reader Text']
  • getByRole('button', { name: 'Reader' })

Fallback

  • section.screen-reader-text-container :nth-of-type(1)
  • .card.screen_reader_text button:nth-of-type(1)
  • form.screen-reader-text-form .field-group:nth-child(1)

Avoid

  • .mt-4.mb-2.flex.items-center > input:nth-child(1)
  • .css-1a2b3c4
  • div[class*='temp-'][class*='hover']

Notes

  • Some parts delay render
  • Icon buttons need aria-label
  • Layout classes may shift
Prev High Contrast Mode
Focus Trap Next