BetaPublic beta — Read the release notes
Documentation

Visually Hidden

Semantic, screen reader, and consumer responsibilities for Visually Hidden.

Package
@solidiom/visually-hidden
Version
0.0.1-next.0
Status
stable

Accessibility

Accessibility contract

Semantics

  • Renders as a `<span>` with inline clipping styles to hide content visually.
  • Content remains in the DOM and the accessibility tree, accessible to screen readers.
  • Carries `data-scope="visually-hidden"` and `data-part="root"` attributes.

ARIA

  • Does not add any ARIA roles or attributes; relies on the natural semantics of wrapped content.
  • The clip/overflow technique ensures content is invisible to sighted users while remaining announced by screen readers.

Consumer responsibilities

  • Use Visually Hidden only for content that is meaningful to screen reader users.
  • Do not use Visually Hidden to hide content that should be visible to all users.
  • Ensure the hidden content provides value to assistive technology users, such as descriptive labels or structural headings.

Not applicable

keyboard
Visually Hidden is a non-interactive display element with no keyboard interactions.
focus
Visually Hidden is a non-interactive display element and does not receive focus.

Review status: Draft — not yet reviewed

This contract describes what the primitive guarantees. Consuming products remain responsible for labels, layout, and workflow decisions that affect the final accessibility result.

Automated evidence

Axe scan summary

Passes
4
Violations
0
Incomplete
0

Latest executed scan: Aug 13, 2026, 10:47 PM

Evidence IDs: axe-visually-hidden-scan-v1

Automated checks cover only the recorded fixture and do not establish complete accessibility conformance.