# XWUIVisuallyHidden

Hide content visually while keeping it accessible to screen readers. Follows ARIA best practices for visually hidden content.

## Basic Usage

Wrap supplementary text so it stays in the accessibility tree but is removed from the visual layout - here, the full "out of 5 stars, based on 320 reviews" context behind a visible "Rating: 4.5".

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Visible text plus a screen-reader-only span that adds context sighted users do not need.
```

## Icon Button Label

An icon-only button gets its accessible name from a visually-hidden span placed inside it, so screen readers announce "Open settings" while sighted users see only the gear glyph.

```example
file: examples/IconButtonLabel.ts
html: examples/IconButtonLabel.html
title: Icon Button Label
description: An icon-only button gets an accessible name from a visually-hidden span inside it.
```

## Toggle Reveal

The `show()` and `hide()` methods flip the wrapped text between screen-reader-only and fully visible - useful for hints that always exist in the accessibility tree but can be surfaced on demand.

```example
file: examples/ToggleReveal.ts
html: examples/ToggleReveal.html
title: Toggle Reveal
description: show() and hide() flip the wrapped text between screen-reader-only and visible.
```

```api
```