# Media Image Zoom

Click to zoom image lightbox with wheel zoom, pinch zoom and drag to pan.

- id: `media-image-zoom`
- Page: https://agentic-ui-kit.com/components/media-image-zoom
- Live preview: https://agentic-ui-kit.com/live/component/media-image-zoom?piece=media-image-zoom

## Install

```bash
agentic-ui add media-image-zoom
npx shadcn@4.17.0 add @agentic-ui/media-image-zoom
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** image-lightbox, wheel-zoom, pinch-zoom, drag-pan, double-click-zoom, gallery-navigation, focus-trap, focus-return, keyboard-zoom, generated-sample-images, dark-mode
- **Intents:** explore-detail, navigate
- **Suits domains:** media, ecommerce, travel, social, knowledge
- **Interaction:** click, drag, wheel, pinch, keyboard-navigation
- **Screen role:** detail
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** click to zoom image lightbox with wheel zoom, pinch zoom and drag to pan, product photo gallery that opens a zoomable viewer with next and previous, accessible image lightbox with focus trap and keyboard zoom controls, gallery thumbnails opening a full screen zoom dialog
- **Avoid when:** cropping or editing an image (use form-image-crop), marking up an image with comments (use agency-image-annotation), comparing two versions of an image (use marketing-before-after), a simple hover magnifier on a product card
- **Preserve when adapting:** focus-return-to-opener, non-passive-wheel, clamped-pan
- **Replace when adapting:** images, captions
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, dialog
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives