Accessibility ms

Kebolehcapaian

🌎 Bahasa: Bahasa Melayu (ms) — lihat semua 33 bahasa

LockedIn CLI adalah jenaka, tetapi kebolehaksesannya tidak. UI terminal yang kaya secara visual ini — tanda perkataan kecerunan, kad lukisan kotak, pemutar braille, emoji — sememangnya sukar digunakan dengan teknologi bantuan melainkan anda mereka bentuk untuknya. Halaman ini menerangkan apa yang CLI lakukan, cara menghidupkannya dan amalan terbaik umum di belakangnya (berguna jauh di luar projek ini).

Empat mod

Mod	Benderakan	Env	Apa yang dilakukannya
Pembaca skrin	--accessible (--a11y, --screen-reader)	LOCKEDIN_ACCESSIBLE=1, atau TERM=dumb	Teks biasa linear bersih: tiada sempadan, tiada seni ASCII, tiada gerakan pemutar, tiada glif hiasan; warna padam; gesaan pendek; tanda tempat semantik ("Siaran:" … "(akhir siaran)").
Kontras tinggi	--high-contrast (--hc)	LOCKEDIN_HIGH_CONTRAST=1	Palet kontras tinggi untuk penglihatan rendah: teks sekunder putih tulen, aksen lebih terang, tiada aksen malap, padat dan bukannya kecerunan kontras rendah.
Gangguan yang rendah	--low-distraction (--calm, --reduce-motion)	LOCKEDIN_LOW_DISTRACTION=1, LOCKEDIN_REDUCE_MOTION=1	Pergerakan yang dikurangkan (tiada animasi pemutar), tiada emoji hiasan, warna pepejal yang tenang — mengekalkan reka letak visual. Untuk mengurangkan beban kognitif/deria.
Plain / monokrom	--plain (--mono, --monochrome)	LOCKEDIN_PLAIN=1, atau NO_COLOR=1	Melumpuhkan semua warna sambil mengekalkan reka letak penuh, jidar dan emoji. Untuk terminal dengan sokongan warna yang lemah, pengelogan atau keutamaan. Mengatasi FORCE_COLOR.

Mereka mengarang: --high-contrast --low-distraction memberikan anda UI yang cerah, tenang, bebas emoji; pengguna pembaca skrin pada a TERM=dumb terminal mendapat mod boleh diakses secara automatik. Apabila mod bercanggah, mod yang lebih ketat akan menang — monokrom mengalahkan palet warna dan mod pembaca skrin menggantikan biasa.

lockedin --accessible post
lockedin --high-contrast
lockedin --plain post
LOCKEDIN_LOW_DISTRACTION=1 lockedin aura

Menukar mod dalam sesi: /a11y

Anda tidak perlu membuat keputusan di hadapan. Di dalam sesi interaktif, /a11y arahan slash ialah panel kawalan yang nyata dan berfungsi (kebolehcapaian bukan sindiran):

Taip	Keputusan
/a11y	Tunjukkan keadaan semasa (hidup/mati) bagi keempat-empat mod
/a11y <mode>	Togol satu: screen-reader, high-contrast, low-distraction, plain (alias seperti sr / hc / calm / mono kerja juga)
/a11y reset	Matikan setiap mod

Keadaan sentiasa ditunjukkan sebagai perkataan hidup/mati yang eksplisit, jangan sekali-kali berwarna sahaja — pengguna yang dilayan ini mungkin tidak melihat warna itu. Panel disetempatkan sepenuhnya.

Amalan terbaik di sebaliknya

Ini adalah prinsip yang kami gunakan — prinsip yang sama digunakan pada mana-mana alat terminal.

1. Semantik berbanding hiasan. Pembaca skrin membaca aksara. Sempadan lukisan kotak menjadi "garisan mendatar, garisan mendatar…"; tanda kata seni ASCII ialah bunyi. Mod boleh diakses menggantikan struktur visual dengan perkataan: percikan mengumumkan "LockedIn CLI" sebagai teks, dan kad mendapat tanda tempat ("Siaran:", "(akhir siaran)") supaya pengguna tahu di mana blok bermula dan berakhir.
2. Jangan sekali-kali bergantung pada warna atau ikon sahaja. Maksudnya yang dibawa hanya dengan warna atau emoji tidak dapat dilihat oleh sesetengah pengguna. Pastikan teks bermakna dengan warna dimatikan — cth. "Disambungkan dengan Ava" dibaca dengan baik sebaik sahaja ✔ hilang.
3. Sediakan alternatif teks / hilangkan bunyi. Emoji hiasan dibaca dengan kuat secara lisan ("📥" → "dulang peti masuk"). Mod boleh diakses jalur glif hiasan semata-mata dan menyimpan perkataan; gangguan rendah menghilangkan emoji yang kuat tetapi mengekalkan reka letak untuk pengguna rabun yang hanya mahukan ketenangan.
4. Hormati pergerakan yang dikurangkan. Animasi (pemutar braille) adalah gangguan dan boleh menjadi pencetus vestibular. Mod boleh diakses dan gangguan rendah jangan bernyawa — ia mencetak status sekali, secara statik. Ini mencerminkan web prefers-reduced-motion.
5. Tawarkan kontras tinggi. Teks kedua "kelabu diredam" kontras rendah gagal WCAG kontras untuk ramai pengguna. Mod kontras tinggi menukarnya dengan putih tulen dan mencerahkan aksen.
6. Kurangkan beban kognitif. Di luar penglihatan, sesetengah pengguna memerlukan kurang: lebih sedikit perkembangan, tiada gerakan, tiada emoji. Itu adalah mod kelas pertama di sini, bukan renungan.
7. Menghormati konvensyen platform. CLI sudah menghormati NO_COLOR; ia juga merawat TERM=dumb (apa yang banyak dieksport oleh pembaca skrin dan cengkerang Emacs) sebagai "boleh diakses", dan dibaca LOCKEDIN_REDUCE_MOTION. Mengesan isyarat sedia ada pengguna berdegup menjadikan mereka mengkonfigurasi perkara lain.
8. Jadikan ia boleh diuji dan pastikan ia diuji. Kebolehaksesan yang tiada dalam pintu ujian reput. Suite ini menegaskan bahawa output boleh diakses mempunyai tiada glif hiasan, tanda tempat terdapat, kontras tinggi menukar palet dan gangguan rendah kekal sejajar — dalam setiap bahasa.

Pemformatan arah juga gagal ditutup. Bahasa Arab, Parsi, Ibrani dan Urdu tidak mengeluarkan kawalan bidi melainkan pengguna menetapkan secara eksplisit LOCKEDIN_BIDI=on untuk terminal yang diketahui menyokong pencilan; mod pembaca skrin menanggalkannya walaupun begitu. Tiada siasatan TTY atau senarai kebenaran terminal boleh mengatasi lalai selamat itu.

Bagaimana ia dibina (untuk yang ingin tahu)

• a11yFilter(s) jalur Unicode hiasan (lukisan kotak, blok, geometri, teknikal, dingbats, braille, emoji) dan siram teks kiri — digunakan pada semua output dalam mod boleh diakses.
• emojiFilter(s) ialah penapis gangguan rendah yang lebih ringan: ia hanya mengeluarkan emoji/simbol yang kuat dan mengekalkan lukisan kotak, peluru, anak panah dan warna ANSI, supaya reka letak visual kekal.
• Objek warna C ditukar kepada palet kontras tinggi di tempatnya; kecerunan kembali kepada aksen pepejal apabila kontras tinggi atau gangguan rendah dihidupkan. Mod Plain memaksa setiap C entri kosong (warna dimatikan sepenuhnya, walaupun di bawah FORCE_COLOR) sambil membiarkan susun atur tidak disentuh.
• renderSplash, pemutar, renderPrompt, dan card mempunyai cabang semantik untuk mod boleh diakses (teks biasa, tiada gerakan, tanda tempat).
• Pengesanan tinggal di detectAccessible / detectHighContrast / detectLowDistraction / detectPlain; titik masuk menggunakan mereka sebelum membuat persembahan. Sesi dalam /a11y perintah (handleA11y + renderA11yStatus) menogol keadaan peringkat modul yang sama secara langsung.

Memastikan ia berfungsi apabila anda menambah ciri

Tutorial senarai semak ulasan termasuk langkah kebolehaksesan dan ini merupakan tabiat yang baik di mana-mana sahaja:

Lari lockedin --accessible <your command> dan sahkan ia dibaca sebagai teks biasa yang bersih — tiada glif hiasan baharu melepasi penapis — dan mana-mana blok berstruktur baharu mempunyai tanda tempat. Kemudian cuba --high-contrast, --low-distraction, dan --plain (yang mesti mengeluarkan tiada kod warna tetapi mengekalkan susun aturnya). Teks baharu yang boleh dilihat pengguna memerlukan kunci dalam setiap himpunan bahasa, jadi /a11y panel dan bantu terus diterjemahkan.

---

_{sindiran. Tidak bergabung dengan LinkedIn. GPL-3.0-or-later.}