Off-screen Element

Difficult DOM Off Intermediate Must Have

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

Difficult DOM / Off-screen

Off-screen Element

One target starts off-canvas and must be brought into view.

Off-screen until revealed

Viewport

Nothing special here. The target starts outside the view.

Hidden target

Was outside viewport; reveal and scroll to interact.

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='off-screen-element-primary']
  • [data-test-id='off-screen-element-secondary']
  • [data-test-id='off-screen-element-action']
  • [aria-label='Off-screen Element']
  • getByRole('button', { name: 'Off' })

Fallback

  • section.off-screen-element-container :nth-of-type(1)
  • .card.off_screen_element button:nth-of-type(1)
  • form.off-screen-element-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