Identity
Avatar
One fixed box for a person or entity: image, derived initials, or icon — never a shifting layout.Semantics and name
The accessible name must match the identity, never the file or glyph.
Accessible name
An explicit alt names the image; otherwise the name labels the root and the image stays decorative.
No duplicate names
alt, name, and decorative cases are mutually exclusive, so nothing is announced twice.
Keyboard and focus
The component supports expected controls without creating focus traps.
Tab order
The avatar is not focusable: it never enters the focus order on its own.
Wrapping controls
Focus ring, hover, and pressed feedback belong to the wrapping button or link.