Spinner
Delapan jari-jari yang memudar bergantian, menandakan "sedang bekerja" untuk tunggu singkat tanpa kemajuan yang terukur. Diletakkan di tempat hasil akan muncul dan tidak pernah memblokir seluruh halaman.
Penggunaan
Pakai saat
- Tunggu singkat (sekitar setengah detik sampai beberapa detik) tanpa ada yang bisa diukur: menyegarkan daftar, memeriksa kode, memuat halaman hasil berikutnya.
- Di dalam kontrol yang sedang sibuk, seperti aksi baris atau konfirmasi di tempat.
- Di ujung daftar saat item berikutnya dimuat.
Pakai yang lain saat
- Tombol sedang menjalankan aksinya: pakai Button. Pakai
.is-loadingdenganbtn__labeldanbtn__spin; lebar tombol tetap. - Konten sedang dimuat dan tata letaknya diketahui: pakai Skeleton.
- Pekerjaannya punya ukuran yang terukur: pakai Progress bar.
- Pekerjaan panjang yang lamanya tidak diketahui (asisten, laporan) saat waktu berjalan penting: pakai Thinking.
- Halaman sedang dimuat setelah tautan diklik: pakai Nav progress.
Letaknya. Di tempat hasil akan muncul: di tengah area yang disegarkan, di ujung baris list yang sibuk, di bawah item terakhir saat item lain dimuat. 20 px inline, 32 px (spinner--lg) di tengah panel. Jangan pernah berupa overlay layar penuh dengan spinner.
Contoh
--c untuk warna lain.<div class="docs-row" style="gap: 28px; color: var(--text-subtle);"> <span class="spinner" role="status" aria-label="Memuat"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span> <span class="spinner spinner--lg" role="status" aria-label="Memuat"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span> <span class="spinner" style="--c: var(--accent);" role="status" aria-label="Memuat"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span> </div>
<div class="list" style="max-width: 420px;"> <div class="lrow"><div class="lrow__body"><div class="lrow__title">Laporan lampu jalan padam, Kedaton</div><div class="lrow__sub">Selesai ditangani</div></div></div> <div class="lrow"><div class="lrow__body"><div class="lrow__title">Laporan saluran tersumbat, Rajabasa</div><div class="lrow__sub">Sedang ditangani</div></div></div> <div class="lrow" role="status" style="justify-content: center; color: var(--text-subtle);"><span class="spinner" aria-hidden="true"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span><span class="lrow__sub" style="margin: 0;">Memuat laporan sebelumnya</span></div> </div>
<div class="list" style="max-width: 420px;"> <div class="lrow" aria-busy="true"><div class="lrow__body"><div class="lrow__title">Transfer bank</div><div class="lrow__sub">Memeriksa pembayaran Anda</div></div><span class="spinner" style="color: var(--text-subtle);" aria-hidden="true"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span></div> </div>
Anatomi
| Bagian | Fungsinya |
|---|---|
.spinner | Wajib. Kotak 20 px (--s) dengan warna teks saat itu (--c). |
i x 8 | Wajib. Delapan jari-jari; masing-masing memudar dengan jeda bertahap. |
.spinner--lg | 32 px dengan jari-jari lebih tebal, untuk pemuatan di tengah panel. |
Varian dan ukuran
| Kelas atau atribut | Kapan |
|---|---|
spinner | 20 px. Inline dan di baris. |
spinner--lg | 32 px. Di tengah panel atau area kosong selama memuat. |
--c | Warna jari-jari. Bawaannya currentColor. |
--s | Ukuran lain (tombol memakai 18 px). |
Gerak dan mikrointeraksi
- Setiap jari-jari menjalankan
lds-spoke(opasitas 1 ke 0,18) selama 800 ms linear, dengan jeda bertambah 100 ms mengelilingi lingkaran, jadi cahayanya tampak berputar tanpa ada yang berotasi. - Reduced motion sengaja tetap membuat spinner berputar: ia melaporkan pekerjaan, dan menghentikannya akan terlihat seperti macet.
- Tampilkan hanya setelah sekitar 300 ms menunggu, agar respons cepat tidak pernah memunculkan spinner sekilas.
Aksesibilitas
- Berdiri sendiri:
role="status"denganaria-label="Memuat"(atau apa yang sedang dimuat), agar diumumkan sekali. - Di dalam sesuatu yang sudah menyatakan sibuk (
aria-busy="true"pada area atau tombol, atau baris status dengan kata-kata):aria-hidden="true"pada spinner. - Saat pemuatan selesai, konten baru atau baris status menyebut hasilnya; hapus spinner, jangan biarkan tersembunyi tetapi tetap diumumkan.
Lakukan dan hindari
Lakukan
- Tunda sekitar 300 ms agar pemuatan cepat tidak menampilkannya.
- Letakkan di tempat konten akan muncul.
- Tambahkan kata-kata jika tunggunya bisa lebih dari dua detik.
Hindari
- Memblokir halaman dengan overlay spinner layar penuh.
- Mengganti label tombol dengan spinner saja; pakai state loading tombol.
- Memakainya untuk pemuatan yang tata letaknya diketahui; pakai skeleton.
Perilaku dan kode
React. Dari lampung-design-system/react.
import { Spinner } from 'lampung-design-system/react';
<span role="status" aria-label="Loading results"><Spinner /></span>
<Spinner size="lg" />