v144 · css

Don't use aria-details for anchor positioning

See the discussion in this issue for more context:

concepts

  1. ARIA vs Anchor

    aria-details is for accessibility relationships, not visual positioning. v144 separates concerns: use anchor= attributes or position-anchor: for layout, aria-details only for assistive tech.

  2. Screen-reader Trace

    Side-by-side: the same tooltip built with aria-details (wrong, double-announces) and with anchor-positioning plus aria-describedby (right).

  3. Refactor Recipes

    The three most common aria-details misuses — tooltip on a button, popover hint on an input, accordion summary — each with before/after code, live demo, and simulated screen-reader trace.

  4. Tooltip Recipe

    A complete accessible tooltip using CSS anchor positioning for placement and aria-describedby (not aria-details) for the semantic link — four placement variants, keyboard + hover triggers, with live CSS code preview.

why it shipped

See the discussion in this issue for more context:

references