# Spinner

> Menunjukkan bahwa sesuatu sedang dimuat atau disimpan.

Spinner menunjukkan bahwa tugas singkat sedang berjalan, misalnya menyimpan form atau memuat daftar.

## Kapan dipakai

- Pakai di dalam tombol selama aksinya berjalan, dengan tombol nonaktif dan label bentuk sedang ("Menyimpan…").
- Pakai untuk tunggu sebentar dengan label di sampingnya, misalnya "Memuat data rilis".
- Pakai [Skeleton](https://design.sosialoka.tech/id/components/skeleton/) kalau bentuk konten yang dimuat sudah diketahui, dan [Progress](https://design.sosialoka.tech/id/components/progress/) kalau kemajuan tugasnya diketahui.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/spinner/_

## Anatomi

1. Track
2. Busur yang berputar

Ikon Lucide `Loader2` 16px (`size-4`) yang berputar dengan `animate-spin`, mengikuti warna teks.

## Varian

Hanya ada satu gaya. Ubah ukurannya dengan kelas `size-*`, misalnya `size-6` untuk halaman yang sedang dimuat.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `aria-label` | `aria-label` | `label` (Semantics) | teks | `Loading` | Apa yang sedang dimuat, misalnya "Menyimpan". |
| `className` | `class` | `SizedBox.square(dimension:)` | kelas | `size-4` | Ukuran. |

## Kode

**React**
```tsx
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"

export default function SpinnerDemo() {
  return (
    <div className="flex flex-wrap items-center gap-6">
      <Button disabled>
        <Spinner aria-label="Menyimpan" />
        Menyimpan…
      </Button>
      <div className="flex items-center gap-2 text-sm text-muted-foreground">
        <Spinner aria-label="Memuat data rilis" />
        Memuat data rilis
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
</script>

<template>
  <div class="flex flex-wrap items-center gap-6">
    <Button disabled>
      <Spinner aria-label="Menyimpan" />
      Menyimpan…
    </Button>
    <div class="flex items-center gap-2 text-sm text-muted-foreground">
      <Spinner aria-label="Memuat data rilis" />
      Memuat data rilis
    </div>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/material.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

// shadcn_ui has no spinner: a 16px CircularProgressIndicator in the primary color stands in.
class Spinner extends StatelessWidget {
  const Spinner({super.key, required this.label, this.color});

  final String label;
  final Color? color;

  @override
  Widget build(BuildContext context) {
    return Semantics(
      label: label,
      liveRegion: true,
      child: SizedBox.square(
        dimension: 16,
        child: CircularProgressIndicator(strokeWidth: 2, color: color ?? ShadTheme.of(context).colorScheme.primary),
      ),
    );
  }
}

class SpinnerDemo extends StatelessWidget {
  const SpinnerDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Wrap(
      spacing: 24,
      runSpacing: 12,
      crossAxisAlignment: WrapCrossAlignment.center,
      children: [
        ShadButton(
          enabled: false,
          leading: Spinner(label: 'Menyimpan', color: theme.colorScheme.primaryForeground),
          child: const Text('Menyimpan…'),
        ),
        Row(
          mainAxisSize: MainAxisSize.min,
          spacing: 8,
          children: [
            const Spinner(label: 'Memuat data rilis'),
            Text('Memuat data rilis', style: theme.textTheme.muted),
          ],
        ),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/spinner.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/spinner.json
```

## Aksesibilitas

- Punya `role="status"`; beri `aria-label` yang menyebut apa yang sedang terjadi.
- Tetap berputar saat `prefers-reduced-motion` aktif: putarannya satu-satunya tanda bahwa tugas masih berjalan.
- Saat tugas selesai, ganti dengan hasilnya, misalnya toast atau daftar yang sudah dimuat.
