Icon-only Buttons

Difficult DOM Icon 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 / Icon-only

Icon-only Buttons

Buttons rely on aria-label instead of visible text.

Awaiting icon click

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='icon-only-buttons-primary']
  • [data-test-id='icon-only-buttons-secondary']
  • [data-test-id='icon-only-buttons-action']
  • [aria-label='Icon-only Buttons']
  • getByRole('button', { name: 'Icon' })

Fallback

  • section.icon-only-buttons-container :nth-of-type(1)
  • .card.icon_only_buttons button:nth-of-type(1)
  • form.icon-only-buttons-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 Dynamic Classes
Deeply Nested DOM Next