Confirm in place
Aksi berisiko yang bertanya, bekerja, dan melapor di dalam satu pil: diam, lalu "Hapus 3 berkas?", lalu Menghapus, lalu Terhapus dengan Urungkan. Pil menyesuaikan lebarnya dengan spring untuk setiap kalimat, jadi elemen di sekitarnya tidak melompat dan orang tidak perlu menghadapi dialog untuk aksi kecil yang bisa diurungkan.
Penggunaan
Pakai saat
- Menghapus, mengeluarkan, atau meninggalkan satu hal, atau pilihan kecil, yang bisa diurungkan: berkas, anggota, grup, pencarian tersimpan.
- Aksinya ada di toolbar, kepala kartu, atau baris, dan dialog terasa lebih berat daripada aksinya.
Pakai yang lain saat
- Aksi tidak bisa diurungkan atau berdampak pada banyak orang (menghapus layanan untuk semua warga): pakai Alert dialog.
- Komitmen yang mahal tetapi tidak berbahaya (mengirim permohonan, membayar): pakai Hold to confirm. Atau geser untuk konfirmasi di ponsel.
- Menghapus baris dengan gestur: pakai Swipe actions.
- Hasilnya terjadi di bagian lain halaman: pakai Toast. Sediakan Urungkan di sana.
Letaknya. Di tempat aksi itu sudah berada: ujung toolbar berkas, kepala kartu, tepi akhir baris daftar. Beri ruang untuk melebar: saat bertanya lebarnya bisa sekitar dua kali lebar diamnya.
Contoh
<div class="confirm" data-lds-confirm> <span class="confirm__face confirm__face--rest"><button class="confirm__arm" data-act="arm"><span class="ic" aria-hidden="true">delete</span>Hapus 3 berkas</button></span> <span class="confirm__face confirm__face--ask"><span class="confirm__q">Hapus 3 berkas?</span><button class="btn btn--plain" data-act="cancel">Batal</button><button class="btn btn--danger" data-act="confirm">Hapus</button></span> <span class="confirm__face confirm__face--busy" role="status"><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="shimmer">Menghapus</span></span> <span class="confirm__face confirm__face--done" role="status"><span class="ic" aria-hidden="true">check_circle</span>3 berkas dihapus<button class="confirm__undo" data-act="undo">Urungkan</button></span> </div>
<div class="card" style="display: flex; align-items: center; gap: 12px; width: 100%; max-width: 560px; flex-wrap: wrap;"> <span class="avatar avatar--sq">KS</span> <span style="flex: 1; min-width: 140px;"><span class="card__title" style="display: block;">Kader Posyandu Sukarame</span><span class="card__sub" style="display: block;">12 anggota, rapat setiap Kamis</span></span> <div class="confirm" data-lds-confirm> <span class="confirm__face confirm__face--rest"><button class="confirm__arm" data-act="arm"><span class="ic" aria-hidden="true">logout</span>Keluar grup</button></span> <span class="confirm__face confirm__face--ask"><span class="confirm__q">Keluar dari Kader Posyandu Sukarame?</span><button class="btn btn--plain" data-act="cancel">Tetap</button><button class="btn btn--danger" data-act="confirm">Keluar</button></span> <span class="confirm__face confirm__face--busy" role="status"><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="shimmer">Memproses</span></span> <span class="confirm__face confirm__face--done" role="status"><span class="ic" aria-hidden="true">check_circle</span>Anda keluar dari grup<button class="confirm__undo" data-act="undo">Urungkan</button></span> </div> </div>
<div class="list" style="width: 100%; max-width: 560px;"> <div class="lrow" style="flex-wrap: wrap;"><span class="avatar" style="--size: 36px;">RS</span><span class="lrow__body"><span class="lrow__title">Rizal Siregar</span><span class="lrow__sub">rizal.siregar@contoh.go.id</span></span><div class="confirm" data-lds-confirm> <span class="confirm__face confirm__face--rest"><button class="confirm__arm" data-act="arm"><span class="ic" aria-hidden="true">person</span>Keluarkan</button></span> <span class="confirm__face confirm__face--ask"><span class="confirm__q">Keluarkan Rizal?</span><button class="btn btn--plain" data-act="cancel">Batal</button><button class="btn btn--danger" data-act="confirm">Keluarkan</button></span> <span class="confirm__face confirm__face--busy" role="status"><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="shimmer">Mengeluarkan</span></span> <span class="confirm__face confirm__face--done" role="status"><span class="ic" aria-hidden="true">check_circle</span>Dikeluarkan<button class="confirm__undo" data-act="undo">Urungkan</button></span> </div></div> </div>
Anatomi
| Bagian | Fungsinya |
|---|---|
.confirm | Wajib. Pilnya, data-lds-confirm. Tinggi 44, lebar mengikuti sisi yang sedang tampil. data-face menyebut sisi mana yang tampil. |
.confirm__face--rest | Wajib. Berisi .confirm__arm (data-act="arm"): ikon dan aksinya, dengan teks warna bahaya. |
.confirm__face--ask | Wajib. .confirm__q (pertanyaan beserta objeknya), tombol Batal polos (data-act="cancel") dan btn--danger (data-act="confirm"). |
.confirm__face--busy | Wajib. Spinner dan kata kerja berkilau ("Menghapus"), role="status". |
.confirm__face--done | Wajib. Tanda centang, kalimat hasil, dan .confirm__undo (data-act="undo"), role="status". |
Status
| Status | Caranya |
|---|---|
rest | data-face="rest": warna bahaya tipis, aksi beserta ikonnya. |
ask | data-face="ask": permukaan dasar dengan cincin; fokus pindah ke Batal. Escape atau Batal kembali ke diam. |
busy | data-face="busy": spinner dan shimmer; tampil minimal 600 ms agar tidak berkedip. |
done | data-face="done": warna sukses tipis, hasilnya, dan Urungkan (difokus). Kembali ke diam setelah data-reset ms (bawaan 5000). |
failed | Jika promise ditolak, pil kembali ke diam dan bergoyang; jelaskan alasannya di sebelahnya. |
Gerak dan mikrointeraksi
- Lebar: pil mengukur sisi berikutnya dan mentransisikan lebarnya dengan
--spring-snappy(--d-snappy, 360 ms); warna latar berganti perlahan selama--d-standard. - Sisi: sisi lama keluar dalam 120 ms dengan
--ease-exit(memudar, blur 2 px, skala 0,98), tetap di tengah agar teks tidak bergeser ke samping; sisi baru masuk dalam 200 ms dengan--ease-entersetelah 60 ms, atau setelah 150 ms bila pil sedang melebar agar kata tidak terpotong. - Selesai: tanda centang muncul dengan
--spring-momentum(360 ms), pantulan kecil yang pantas untuk aksi yang tuntas. - Gagal:
shake()(360 ms, dua ayunan) ditambah haptic error. - Interupsi: setiap langkah adalah transisi dari lebar saat ini; bersiap lalu membatalkan dengan cepat berbalik dengan mulus.
- Reduced motion: lebar berubah dalam 120 ms, sisi langsung berganti, tanpa pantulan dan tanpa goyangan.
Aksesibilitas
- Setiap sisi berisi tombol sungguhan. Saat bersiap, fokus pindah ke Batal (pilihan aman); saat selesai, fokus pindah ke Urungkan; batal dan reset mengembalikannya ke tombol aksi.
- Sisi sibuk dan selesai memakai
role="status", jadi "Menghapus" dan "3 berkas dihapus" diumumkan. - Pertanyaannya menyebut objek ("Hapus 3 berkas?"), jadi tetap jelas di luar konteks.
Lakukan dan hindari
Lakukan
- Sebut objeknya di label aksi, pertanyaan, dan hasil.
- Panggil
e.detail.wait(promise)agar sisi sibuk bertahan selama pekerjaan sebenarnya berjalan. - Pastikan Urungkan benar-benar memulihkan, dan dengarkan
lds:undo.
Hindari
- Memakainya untuk aksi yang tidak bisa diurungkan; pakai alert dialog.
- Menaruh dua konfirmasi berdampingan dalam satu baris.
- Menampilkan toast juga; pil sudah menyampaikannya.
Perilaku dan kode
HTML biasa. init() menghubungkan [data-lds-confirm]. Saat dikonfirmasi, komponen memancarkan lds:confirm dengan { wait }; berikan promise Anda ke wait untuk menahan sisi sibuk (penolakan mengembalikan ke diam dengan goyangan). Tanpa wait, pil selesai setelah 700 ms. lds:undo terpicu saat Urungkan. data-reset mengatur berapa lama sisi selesai tampil (ms). Haptic light saat bersiap, haptic success saat selesai.