Responsif dan Aksesibilitas
Persyaratan keyboard, fokus, sentuhan, dan seluler untuk komponen Qokit dan ekstensi platform.
Responsif dan Aksesibilitas
Semua komponen publik dan antarmuka integrasi harus mendukung keyboard, sentuhan, dan panjang bahasa yang berbeda. Seluler harus menyusun ulang tata letak berdasarkan tugas, bukan sekadar memperkecil antarmuka desktop.
Keyboard dan Fokus
- Gunakan Button, Link, Label, Heading, Table, dan List yang semantik;
- Semua interaksi dapat diakses dan dioperasikan melalui keyboard;
- Gunakan
focus-visibledan--focus-ringbersama, jangan hapus umpan balik fokus; - IconButton harus menyediakan
aria-labelyang terlokalisasi; - Tooltip hanya boleh melengkapi penjelasan, tidak boleh menggantikan nama aksesibilitas.
Sentuhan dan Status
- Area klik kontrol kompak minimal 40px, operasi utama seluler minimal 44px;
- Hover tidak boleh menjadi satu-satunya petunjuk;
- Status Disabled, Loading, Empty, dan Error harus memiliki umpan balik yang mudah dipahami;
- Operasi berbahaya menggunakan teks yang jelas dan alur konfirmasi, tidak boleh hanya mengandalkan warna merah.
Tata Letak Responsif
- Antarmuka kolom ganda di bawah tablet beralih ke kolom tunggal, dilipat, atau menjadi drawer berdasarkan prioritas tugas;
- Header, Toolbar, tabel, kotak pratinjau, dan grup operasi mempertahankan ukuran stabil;
- Label panjang, teks terjemahan, dan konten pengguna tidak boleh menutupi operasi tetangga;
- Desktop dan seluler harus memverifikasi konten nyata, urutan fokus, dan overflow horizontal.
Konten dan Kontras
- Teks tubuh, penjelasan, dan CTA tetap dapat dibaca di latar belakang terang, gelap, dan bertema;
- Gambar menyediakan teks alternatif yang sesuai dengan konten;
- Status tidak boleh diekspresikan hanya melalui warna;
- Animasi menghormati
prefers-reduced-motion, alur kritis tidak bergantung pada animasi untuk penyelesaian.