# ImageGroup changelog

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

Reviewed against Chinese source SHA-256 `18ba1e32cbee08fa2f528ee67a128f80b25fb4ca3320e9aa2926ce9d024df1ef`. For version differences, check the installed package as well.

- 2026-09-21: Unified the usage guide, source property table, and Site / AI reading entry points. Documentation only; component behavior is unchanged.

- **ImageGroup-Docs.2026-05-25** Archived the historical changelog at the top of the source file. Subsequent changes go in this document’s changelog; the source header retains only responsibilities, current key architecture, and the documentation path.

<a id="v112-2026-03-13"></a>

### v1.1.2 (2026-03-13)

<a id="调整"></a>

#### Adjustments

- **IG-Adjust.8** Expanded the in-group image size scale to `12/16/20/24/28/32/40/48/56/64/72/80`, matching `Image`.

<a id="v111-2026-03-13"></a>

### v1.1.1 (2026-03-13)

<a id="调整-1"></a>

#### Adjustments

- **IG-Adjust.7** Removed the compatibility prop `disableImageViewer`; only `previewMode` now controls the default preview mode for images in the group.

<a id="v110-2026-03-12"></a>

### v1.1.0 (2026-03-12)

<a id="调整-2"></a>

#### Adjustments

- **IG-Adjust.5** Added `previewMode="viewer" | "window" | "none"` as the default preview mode for in-group `Image` components.

<a id="v107-2026-03-10"></a>

### v1.0.7 (2026-03-10)

<a id="新功能"></a>

#### New features

- **IG-Feat.5** Added `disableImageViewer` to force in-group `Image` components to open in a new window.

<a id="调整-3"></a>

#### Adjustments

- **IG-Adjust.2** In-group preview coordination now uses a single page-level `ImageViewer`. `ImageGroup` only registers media and snapshots the list; an embedded Viewer is no longer required.

<a id="v108-2026-03-11"></a>

### v1.0.8 (2026-03-11)

<a id="调整-4"></a>

#### Adjustments

- **IG-Adjust.3** `getPreviewItems()` now returns the current stable snapshot reference directly, avoiding another copy of the group media array when opening Viewer.

<a id="v109-2026-03-11"></a>

### v1.0.9 (2026-03-11)

<a id="调整-5"></a>

#### Adjustments

- **IG-Adjust.4** The group media registry is now maintained in place with `push/splice`, further reducing short-lived array allocations as images mount and unmount.

<a id="v104-2026-03-10"></a>

### v1.0.4 (2026-03-10)

<a id="新功能-1"></a>

#### New features

- **IG-Feat.4** Added an in-group preview context: `Image` can register its media automatically, and an in-group `ImageViewer` can consume `items/open/index` automatically.

<a id="v103-2026-03-10"></a>

### v1.0.3 (2026-03-10)

<a id="修复"></a>

#### Fixes

- **IG-Fix.2** Fixed `layout="grid"` appearing as a row because it had no default column rule. Grid mode now defaults to a two-column template.

<a id="v102-2026-03-10"></a>

### v1.0.2 (2026-03-10)

<a id="修复-1"></a>

#### Fixes

- **IG-Fix.1** Fixed `layout` not taking effect. `ImageGroup` now maps `layout="row" | "column" | "grid"` correctly to the corresponding `Frame` keywords and removes an incorrect internal `display` override.

<a id="v101-2026-03-10"></a>

### v1.0.1 (2026-03-10)

<a id="调整-6"></a>

#### Adjustments

- **IG-Adjust.1** Defined a fixed `4px` gap for all `row / column / grid` layouts, with a `gap: var(--gap-1)` fallback in component styles.

<a id="v100-2026-03-10"></a>

### v1.0.0 (2026-03-10)

<a id="新功能-2"></a>

#### New features

- **IG-Feat.1** Added ImageGroup with a shared image size across the group.
- **IG-Feat.2** Provides `row / column / grid` layouts; `stack` is not supported.
- **IG-Feat.3** Fixed the default gap at `var(--gap-1)` without exposing a `gap` prop.

[Component guide](https://snowui.dev/llms/en/components/image-group.md) · [Full reference](https://snowui.dev/llms/en/components/image-group/reference.md)