Spinner
Spinner menunjukkan bahwa tugas singkat sedang berjalan, misalnya menyimpan form atau memuat daftar.
Kapan dipakai
Section titled “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 kalau bentuk konten yang dimuat sudah diketahui, dan Progress kalau kemajuan tugasnya diketahui.
Memuat data rilis
Memuat data rilis
Anatomi
Section titled “Anatomi”- 1Track
- 2Busur yang berputar
Ikon Lucide Loader2 16px (size-4) yang berputar dengan animate-spin, mengikuti warna teks.
Varian
Section titled “Varian”Hanya ada satu gaya. Ubah ukurannya dengan kelas size-*, misalnya size-6 untuk halaman yang sedang dimuat.
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/spinner.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/spinner.jsonAksesibilitas
Section titled “Aksesibilitas”- Punya
role="status"; beriaria-labelyang menyebut apa yang sedang terjadi. - Tetap berputar saat
prefers-reduced-motionaktif: putarannya satu-satunya tanda bahwa tugas masih berjalan. - Saat tugas selesai, ganti dengan hasilnya, misalnya toast atau daftar yang sudah dimuat.
