Visually Hidden.
Heard by assistive tech, unseen on screen.
VisuallyHidden clips content to a 1px box while keeping it in the accessibility tree. With focusable, it reappears while something inside it has focus: the skip-link pattern.
Make it yours
Preparing the example…
Composition
AnatomyVisuallyHidden clips content to a 1px box while keeping it in the accessibility tree. With focusable, it reappears while something inside it has focus: the skip-link pattern.
VisuallyHidden (span by default)
└── text or a focusable skip linkA place to start
UsageImport the stylesheet once at your application root. This complete example reflects the properties selected above.
Loading example…
Details that make a difference
Examples & statesThe finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native HTML attributes and refs are forwarded. The table covers Dixy’s own options.
VisuallyHiddenOwn
| Prop | Type / description | Default |
|---|---|---|
focusable | booleanReveal the content while it, or something inside it, has keyboard focus (skip links). | false |
Built from the same foundations
Styling tokensChange Theme settings above to compare appearance, accent, neutral, radius, spacing density, motion and direction. Override component aliases on a Theme root so custom properties follow portaled content too. The wrapper merges className, style, refs and render composition with its owning primitive.
| Token | Purpose |
|---|---|
--dixy-color-text-primary | The component-specific starting point. |
--dixy-font-label-md | Control label font and line height; body roles remain readable in text inputs. |
--dixy-color-background-selected | Selected surfaces use semantic color across appearances. |
--dixy-color-border-focus | Focus indication remains visible independently of shadows. |
--dixy-spacing-inset-sm | Density-aware component padding. |
--dixy-motion-transition-feedback | Short state feedback, reduced by the inherited motion setting. |
Consider everyone
AccessibilityUse for supplementary text and skip links. Do not hide interactive controls without focusable, or keyboard users will land on something invisible. Target WCAG 2.2 AA. Automated axe checks pass in unit tests; screen-reader, forced-colors and contrast verification in real browsers remains pending.
Target: WCAG 2.2 AA. Automated tests cover selected behavior; manual screen-reader, contrast, and zoom validation remain part of the release checklist.
Build it. Then understand it.
display:none and visibility:hidden remove content from the accessibility tree; clipping keeps it there. Choose based on who should perceive it.
--dixy-color-text-primary