AddThisFeature

Accessible Name Validator

Find every control a screen reader announces as nothing useful.

moderate Accessibility & Internationalization

What it adds

An audit of the computed accessible name of each interactive element in the rendered interface.

What your agent is told to do

5
  1. 1

    Compute the name the way assistive technology does — following the resolution order through labels, referenced elements, attributes, and text content — rather than reading the source markup and guessing.

  2. 2

    Report three separate failures: an empty name, a generic name such as button, link, or here, and duplicate names within the same context where several controls announce identically.

  3. 3

    Prefer a fix that adds a visible label. A control given a hidden name is announced but still mysterious to the sighted user who cannot tell two identical icons apart.

  4. 4

    Handle icon-only buttons and composite controls explicitly: a control built from an icon, a count, and a status dot must resolve to one coherent phrase, not a run-on of three fragments.

  5. 5

    Do not fix a missing name by stacking attributes. Overlapping naming and description attributes produce double announcements, and the validator should flag that as its own failure rather than only the absence of a name.

Edge cases it handles

7
  • Empty names, generic names, and names duplicated across sibling controls are three distinct failures with three different fixes, and a validator reporting only emptiness misses most real cases.
  • A visible label is preferable to a hidden one wherever the layout allows it, because the hidden name helps only some users and leaves the ambiguity in place for everyone else.
  • Icon-only controls and composite controls need a deliberate name; letting the name fall through to the concatenated text of the children produces announcements like edit 3 overdue.
  • Conflicting naming and description attributes cause the same phrase to be read twice, which the audit must catch rather than treating any non-empty name as a pass.
  • Names generated from record data must be checked with real values, since a row action named after an empty or untitled record announces as nothing at all.
  • In a translated interface the name must come from the same translation source as the visible text, or the two drift and the spoken label stops matching the screen.
  • Controls rendered only in an open menu, dialog, or drawer must be included, which means the audit has to open them rather than scanning the initial page.

Definition of done

9
  • Every interactive element in the app resolves to a non-empty accessible name.
  • The validator computes names through the standard resolution order rather than reading markup.
  • Empty, generic, and duplicated names are reported as separate categories.
  • No control produces a doubled announcement from conflicting attributes.
  • Icon-only and composite controls each resolve to a single coherent phrase.
  • Controls inside menus, dialogs, and drawers are covered by the audit.
  • Names derived from record data hold up when the underlying record is untitled.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.