ui · Primitive rsc-safe
VisuallyHidden
@devalok/shilp-sutra/ui/visually-hiddenView in Storybook Hand-curated previews ship in rolling waves. See it live in Storybook →
Reference
Props
standard span attributes
Example
<VisuallyHidden>Screen reader only text</VisuallyHidden>
Composability
- Server-safe. Works anywhere — no context, no cascade.
- Canonical use: wrap a DialogTitle / SheetTitle that must exist for a11y but shouldn't show visually (
<DialogTitle asChild><VisuallyHidden>...</VisuallyHidden></DialogTitle>). - Also useful inside IconButton to provide a text alternative when the icon already has an aria-label (redundant label is harmless and helps some screen readers).
- Uses the
sr-onlyCSS pattern under the hood — content is in the DOM, just positioned off-screen.
Gotchas
- Content is visually hidden but accessible to screen readers
- Useful for providing accessible labels without visual UI
- Don't use for content you want hidden entirely — that's
hiddenor conditional rendering
Changes
v0.1.0
- Added Initial release