# Lens Pager

Paging through a lens, for moments where paging is the experience.

Tier: Free

## Installation

```bash
npx shadcn add @fetaui/lens-pager
```

## Usage

```tsx
import { LensPager } from '@/components/fetaui/lens-pager'

export function Example() {
  return <LensPager pages={12} page={page} onPageChange={setPage} />
}
```

## API

| Prop | Type | Default |
|---|---|---|
| pages | number | required |
| page | number |  |
| defaultPage | number | 1 |
| onPageChange | (page) => void |  |
| aria-label | string | Pagination |
| animated | boolean | true |

## When to use

- When paging is the point, like a reader.

## When not to use

- For lists and tables: use Pagination.

## Accessibility

- A nav labelled Pagination, with labelled arrows. Reaching the end moves focus to the other arrow.
- The count is announced politely. The strip is decorative.

## Motion

- The strip rolls one slot at a time on a spring, and the current number scales up from 20 to 30.
- The notch stays fixed.
- With reduced motion, numbers swap.