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.