# Spinner changelog

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

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

<a id="v123-2026-10-20"></a>

### v1.2.3 (2026-10-20)

- The default loading status name follows LocaleProvider; an explicit aria-label takes priority. External loading descriptions remain caller-owned text.

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

- **Spinner-Docs.2026-05-25** Archived the historical changelog from the source header. New changes now belong in this document’s changelog; the source header retains only its role, current key architecture, and documentation path.

<a id="v122-2026-03-06"></a>

### v1.2.2 (2026-03-06)

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

#### Changes

- **SP-Bridge.3** When an external `loopMotion.preset` is supplied, Spinner explicitly removes that preset before forwarding motion to the root Frame, avoiding double rotation of the root and inner spinner.

<a id="v121-2026-03-06"></a>

### v1.2.1 (2026-03-06)

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

#### Changes

- **SP-Bridge.1** Looping animation now consumes Frame `loopMotion` bridge variables for duration, easing, iteration, direction, and playState.
- **SP-Bridge.2** Default speed still derives from `variant + speed`: `circle = 1000ms / speed` and `spokes/pills = 800ms / speed`. Explicit `loopMotion.duration` takes precedence.

<a id="v120-2026-02-23"></a>

### v1.2.0 (2026-02-23)

<a id="改进"></a>

#### Improvements

- **SP-Perf.1** The circle variant changed from a `radial-gradient` mask to an SVG data URI mask to remove jagged edges at small sizes.
- **SP-Perf.2** SVG `<circle>` strokes provide vector antialiasing for the ring; the SVG engine renders both inner and outer edges.
- **SP-Refactor.1** Moved `sizeMap` to a module-level constant and changed all English comments to Chinese.

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

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

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

#### Fixes

- **SP-Fix.1** Completed explicit Frame CSS behavior and capability-switch parameters and aligned internal variable naming.

<a id="3-尺寸-sizes"></a>

### 3. Sizes

```svelte
<div class="flex gap-4 items-end">
    <Spinner size={16} />
    <Spinner size={32} />
    <Spinner size={48} />
</div>
```

<a id="4-颜色-colors"></a>

### 4. Colors

Set color through CSS classes.

```svelte
<Spinner class="text-blue-500" />
<Spinner variant="spokes" class="text-green-500" />
```

<a id="5-速度-speed"></a>

### 5. Speed

```svelte
<Spinner speed={0.5} /> <!-- 0.5x Slow -->
```

<a id="6-统一循环动效桥接"></a>

### 6. Unified looping-motion bridge

Spinner now exposes unified `--snowui-frame-loop-motion-*` variables through `Frame loopMotion`; its internal `animation-*` properties consume them.

```svelte
<!-- Default: derived from variant + speed -->
<Spinner variant="circle" speed={1.5} />

<!-- Explicitly override the Frame looping-motion bridge -->
<Spinner loopMotion={{ duration: 1200, easing: 'linear', iterationCount: 'infinite' }} />
```

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