# ImageViewer

Read the complete [LICENSE](https://snowui.dev/LICENSE) for the installed version before use.

Preview images or videos at page level with previous, next, and close controls.

We are building SnowUI components into interfaces people can use directly in AI conversations. Conversational UI is still in development; this page demonstrates website usage. Supported chat platforms and component versions will be announced after verification. Generating and using SnowUI interfaces inside AI conversations is completely free. It is not a project, uses no project or developer-seat quota, and requires no SnowUI registration, activation, or paid proof.

Package: `@snowui-design-system/components`. Import: `import { ImageViewer } from '@snowui-design-system/components';`. Source fingerprint: `c724d15ba3e7630f6a71d9ec59af7ec5297b10ca95237a272bc6b699371a9f19`.

## Usage choices

Use ImageViewer to enlarge images and navigate a group. Use Image for ordinary in-page display. Reuse the existing zoom, close, and keyboard interactions rather than rebuilding them.

- Omit open, items, and index together for page-wide automatic mode. In manual mode, provide the preview list and current item explicitly.
- children replaces every default control Button. Use parts when only changing their appearance so close and previous/next controls remain available.

## Read as needed

- [API](https://snowui.dev/llms/en/components/image-viewer/api.md): Public Props and defaults
- [Types and states](https://snowui.dev/llms/en/components/image-viewer/types.md): Public type declarations and binding rules
- [Full reference](https://snowui.dev/llms/en/components/image-viewer/reference.md): Composition and interaction boundaries
- [Styles](https://snowui.dev/llms/en/components/image-viewer/styles.md): Registered public overrides
- [Examples](https://snowui.dev/llms/en/components/image-viewer/examples.md): Code and preview links
- [Image index](https://snowui.dev/llms/components/image-viewer/images.json): Use only if appearance remains uncertain
- [Changelog](https://snowui.dev/llms/en/components/image-viewer/changelog.md): Version history reviewed in English

[Design guide](https://snowui.dev/llms/en/design-system.md) · [Styling guide](https://snowui.dev/llms/en/styling.md)