Returnless UI

Visually Hidden

Use when an element needs to be available to assistive technology (for example, a screen reader) but otherwise hidden.

Usage

js
<script lang="ts" setup>
import { VisuallyHidden } from '@returnless/focus-ui';
</script>

<template>
  <VisuallyHidden>
    <p>This text is invisible</p>
  </VisuallyHidden>
</template>

Best practices

Visually hidden should:

  • Not be used if semantic markup can make content understandable to people using assistive technologies.
  • Be used to provide extra context when semantic markup isn't enough.
  • Be used on any content that is normally present but is being omitted.
  • Make sense in context when used with a screen reader.

Accessibility

The visually hidden component styles text so that it’s not visible, but it is available to assistive technologies like screen readers and other text to speech programs.

The component shouldn’t be used to hide interactive content.