# Expandable Text

Copy clamped on a line boundary that unrolls from where you were reading.

Tier: Free

## Installation

```bash
npx shadcn add @fetaui/expandable-text
```

## Usage

```tsx
import { ExpandableText } from '@fetaui/components/expandable-text'

export function Example() {
  return <ExpandableText><p>Thrown by hand in a small studio.</p></ExpandableText>
}
```

## API

| Prop | Type | Default |
|---|---|---|
| children | <p> elements | required |
| lines | number | 3 |
| defaultOpen | boolean | false |
| onOpenChange | (open) => void |  |
| moreLabel, lessLabel | string |  |
| moreAriaLabel | string | Show the full description |
| animated | boolean | true |

## When to use

- For copy longer than three lines.

## When not to use

- For anything people need in order to decide.

## Accessibility

- Every paragraph stays in the DOM, so screen readers read it all.
- Read more is labelled Show the full description.

## Motion

- Height goes from three lines to full in 320 ms and keeps your place.
- With reduced motion, it jumps.