Shake
Tanda penolakan: kontrol bergoyang dua kali, cepat dan dengan ayunan yang mengecil (360 ms), dan alasannya muncul dalam kata-kata di sampingnya. Goyangan menarik mata tepat ke tempatnya; kata-katanya menjelaskan apa yang harus dilakukan.
Penggunaan
Pakai saat
- Orang menekan Lanjut atau Kirim dan inputnya ditolak: email tanpa domain, kode salah, kata sandi salah.
- Aksi optimistis dibatalkan oleh server (like, confirm in place, inline edit melakukannya untuk Anda).
- Batas menolak input tepat saat tercapai: stepper yang sudah di nilai maksimum, kuota antrean yang penuh.
Pakai yang lain saat
- Validasi saat mengetik: pakai Text field. Tampilkan pesan setelah kolom ditinggalkan atau saat dikirim, tanpa goyangan.
- Error dari sistem, bukan dari orangnya (server mati): pakai Alert.
- Konfirmasi aksi berisiko: pakai Confirm in place.
- Menarik perhatian ke sesuatu yang baru: pakai Bell.
Letaknya. Pada elemen terkecil yang ditolak: kontrol kolom (.control), baris OTP, tombol yang ditekan. Jangan pernah pada seluruh formulir, kartu, atau halaman.
Contoh
import { shake } from 'lampung-design-system/js';
if (!valid) {
control.classList.add('is-invalid');
input.setAttribute('aria-invalid', 'true');
help.hidden = false; // the reason, in words
shake(control); // plus an error haptic on phones
}import { otpError } from 'lampung-design-system/js';
otpError(document.querySelector('.otp-wrap')); // red cells and one shake; typing clears bothGerak dan mikrointeraksi
lds-shakeselama 360 ms dengan--ease-standard: −6 px, +5 px, −3 px, +2 px, diam. Dua ayunan yang mengecil, seperti kepala menggeleng; berakhir tepat di posisi awal.shake(el)memulai ulang animasi bila dipanggil lagi di tengah goyangan dan melepas.is-shakesaat selesai. Fungsi ini juga memanggilhaptic('error').- Keadaan merah (
is-invalid,otp.is-error) muncul seketika bersama goyangan dan bertahan sampai input berubah; goyangannya sendiri main sekali. - Reduced motion: tanpa goyangan (1 ms). Keadaan merah dan kata-katanya yang membawa penolakan, karena itu kata-kata wajib ada.
Aksesibilitas
- Selalu tulis alasannya dalam teks, hubungkan dengan
aria-describedby, dan pasangaria-invalid="true"pada input. - Pindahkan fokus ke kolom yang ditolak jika belum ada di sana.
- Jangan pernah memakai goyangan sebagai satu-satunya tanda error; goyangan tidak terlihat oleh pembaca layar dan saat reduced motion.
Lakukan dan hindari
Lakukan
- Goyangkan kontrol yang ditolak, tepat di tempatnya.
- Sebut apa yang harus dilakukan: "Lengkapi akhir alamatnya, misalnya …".
- Pakai
shake()agar haptic dan perilaku mulai ulang ikut terpasang.
Hindari
- Menggoyangkan seluruh formulir, kartu, atau dialog.
- Menggoyangkan selagi orang masih mengetik.
- Menggoyangkan saat berhasil, atau untuk menarik perhatian.
Perilaku dan kode
HTML biasa. shake(el) menambahkan .is-shake (memulai ulang bila perlu), melepasnya setelah selesai, dan menjalankan haptic error. otpError(wrap) menandai baris OTP sebagai salah dan menggoyangkannya. likeRevert, pil konfirmasi, dan inline edit memanggilnya saat gagal.
React. Dari lampung-design-system/react.
import { reject } from 'lampung-design-system/react';
if (!valid) { setError('Add the end of the address, like ana.putri@campus.ac.id.'); reject(controlRef.current); }