Pelatihan

Kursus mandiri bagi tim yang mengadopsi Lily: delapan modul, masing-masing dengan tujuan, bacaan, latihan yang Anda kerjakan di peramban sungguhan, dan uji mandiri beserta jawabannya. Sekitar satu hari secara keseluruhan; satu modul per sesi sudah pas.

Sebelum memulai

Pilih satu tutorial kerangka kerja dan selesaikan dulu. Jalankan salah satu aplikasi contoh secara lokal, atau gunakan halaman komponen di sini, untuk latihannya. Anda memerlukan papan ketik, dan untuk modul 8 pembaca layar: VoiceOver di macOS dan iOS, NVDA di Windows, atau TalkBack di Android, semuanya gratis.

Modul 1 — Arti headless

Tujuan: tahu apa yang diputuskan Lily dan apa yang Anda putuskan.

Baca: halaman Tentang, dan satu halaman komponen, misalnya Button, dari awal sampai akhir.

Kerjakan: tampilkan sebuah Button dan sebuah TextInput tanpa lembar gaya. Lalu tautkan satu tema, kemudian tema lain. Catat apa yang berubah dan apa yang tidak.

Uji mandiri: apa yang tidak pernah dibawa komponen Lily? Apa yang selalu dibawanya?

Tidak pernah: CSS, fon, ikon atau gambar (kecuali ikon pemilih), teks bahasa Inggris, pengambilan data, lokal atau mata uang bawaan. Selalu: elemen HTML yang paling tepat, kelas kebab-case-nya di depan, ARIA di tempat HTML tidak cukup, perilaku papan ketik, dan atribut Anda yang lain diteruskan.

Uji mandiri: Anda ingin garis tepi merah pada satu tombol. Di mana tempatnya?

Di CSS Anda, pada kelasnya (.button) atau kelas yang Anda tambahkan. Tidak pernah di komponen.

Modul 2 — Papan ketik dan fokus

Tujuan: memakai dan menguji setiap komponen tanpa tetikus.

Baca: tabel Interaksi Papan Ketik pada TabBar, Listbox dan Dialog.

Kerjakan: cabut tetikus. Di masing-masing dari tiga halaman itu, capai demonya dengan Tab dan lakukan semua yang tercantum di tabel. Buka dialognya, tekan Escape, lalu catat ke mana fokus mendarat.

Uji mandiri: mengapa bilah tab hanya mengambil satu perhentian Tab dan bukan satu per tab?

Pola komposit APG: Tab berpindah antarwidget, dan tombol panah berpindah di dalam satu widget (indeks tab berpindah). Bilah tab dengan sepuluh perhentian membuat pengguna papan ketik menekan Tab sepuluh kali untuk melewatinya.

Uji mandiri: setelah dialog modal ditutup, di mana fokus seharusnya?

Pada kontrol yang membukanya. Dialog modal Lily memakai showModal(), yang juga menjaga Tab tetap di dalam dialog selama terbuka.

Modul 3 — Nama, peran, dan keadaan

Tujuan: memberi setiap kontrol nama yang dapat diucapkan pembaca layar, dengan kata-kata Anda.

Baca: bagian ARIA dari IconButton dan SwitchButton.

Kerjakan: di aplikasi Anda sendiri, dengan server pengembangannya berjalan, tampilkan IconButton tanpa label. Buka konsol peramban: Lily memperingatkan bahwa kontrol tidak punya nama yang dapat diakses. Tambahkan labelnya dan periksa bahwa peringatan hilang. (Peringatan hanya ada di build pengembangan, jadi halaman produksi, seperti situs ini, tetap diam.)

Uji mandiri: kapan memakai aria-label, dan kapan teks yang terlihat?

Teks yang terlihat kapan pun bisa: semua orang melihatnya, dan pengguna input suara dapat mengucapkannya. aria-label hanya bila tidak ada teks yang terlihat, seperti ikon. Bila keduanya ada, nama harus memuat kata-kata yang terlihat (WCAG 2.5.3).

Uji mandiri: status ditampilkan hanya dengan warna merah. Apa yang kurang?

Teks. Warna boleh mengulang makna tetapi tidak pernah membawanya sendirian (WCAG 1.4.1); status memerlukan kata-kata.

Modul 4 — Formulir

Tujuan: membuat formulir yang galatnya dapat ditemukan dan diperbaiki siapa pun.

Baca dan kerjakan: tutorial formulir aksesibel, kelima langkahnya.

Uji mandiri: formulir gagal validasi. Ke mana fokus pergi, dan apa yang dibacakan?

Ke ringkasan galat, yang diumumkan dengan judul dan daftar tautannya, satu per galat, masing-masing menuju isiannya.

Uji mandiri: mengapa tidak menonaktifkan tombol kirim sampai formulir valid?

Tombol nonaktif tidak bisa mengatakan apa yang salah, dan banyak orang tidak tahu mengapa tombol itu tidak berbuat apa-apa.

Modul 5 — Tema dan kontras

Tujuan: mengubah gaya Lily tanpa merusak kontras atau fokus.

Baca: tutorial tema dan tabel kontras tema .

Kerjakan: timpa --color-primary dengan warna merek Anda sendiri. Periksa bahwa pasangannya, --color-primary-content, mencapai 4,5:1, dan bahwa cincin fokus tetap terlihat di atas halaman.

Uji mandiri: warna merek Anda terlalu pucat untuk teks putih. Masih bisakah dipakai?

Bisa, sebagai hiasan (--lily-brand: pita kepala, garis, latar logo), tidak pernah untuk teks atau batas kontrol. Teks dan batas memakai pasangan konten tema.

Modul 6 — Seluruh dunia

Tujuan: tidak menjadikan negara mana pun sebagai bawaan.

Baca dan kerjakan: formulir yang bekerja di seluruh dunia.

Uji mandiri: mengapa CurrencyInput tidak punya mata uang bawaan?

Bawaan apa pun akan menjadi uang satu negara, diam-diam salah di tempat lain. Bila currencyCode tidak ada, itu cacat pada pemanggil.

Uji mandiri: halaman berbahasa Arab. Apa yang Anda tetapkan, dan apa yang harus dilakukan CSS Anda?

lang="ar" dan dir="rtl" (pemilih bahasa menetapkan keduanya); CSS Anda memakai properti logis sehingga tata letak tercermin dengan sendirinya.

Modul 7 — Gerak

Tujuan: menganimasikan tanpa merugikan siapa pun.

Baca: resep gerak.

Kerjakan: aktifkan "kurangi gerak" di sistem operasi Anda dan muat ulang halaman dengan resep marquee. Ia harus diam dan membungkus baris. Lalu capai tombol jedanya dengan papan ketik.

Uji mandiri: sesuatu bergerak sendiri lebih dari lima detik. Apa yang harus dimilikinya?

Cara untuk menjeda, menghentikan, atau menyembunyikannya (WCAG 2.2.2), yang dapat dicapai dengan papan ketik, bukan hanya dengan mengarahkan penunjuk.

Modul 8 — Periksa hasil kerja Anda

Tujuan: menguji halaman seperti Lily menguji halamannya sendiri.

Kerjakan: ambil satu halaman yang Anda buat dalam kursus ini dan jalankan empat pemeriksaan:

  1. axe (ekstensi peramban, atau @axe-core/playwright dalam tes): tidak ada pelanggaran.
  2. Hanya papan ketik: setiap tugas selesai, fokus selalu terlihat, tidak pernah terjebak.
  3. Perbesar ke 400% dan sempitkan jendela ke 320 piksel: tidak ada gulir ke samping, tidak ada yang terpotong.
  4. Pembaca layar: setiap kontrol punya nama, peran, dan keadaannya, dan galat diumumkan.
Uji mandiri: axe tidak melaporkan pelanggaran. Apakah halamannya aksesibel?

Belum terbukti. Pemeriksaan otomatis menemukan mungkin sepertiga masalah; pemeriksaan papan ketik, zoom, dan pembaca layar menemukan sebagian besar sisanya. Lihat halaman kualitas untuk apa yang sudah dan belum diverifikasi Lily sendiri.

Setelah kursus