Skip to content

Accessibility tl

James Morris edited this page Jul 29, 2026 · 1 revision

Accessibility

🌎 Wika: Tagalog (tl)tingnan ang lahat ng 33 wika

LockedIn CLI ay isang biro, ngunit ang pagiging naa-access nito ay hindi. Ang terminal na UI na ganito kayaman — gradient wordmark, box-drawing card, braille spinners, emoji — ay talagang mahirap gamitin sa pantulong na teknolohiya maliban kung magdidisenyo ka para dito. Ipinapaliwanag ng page na ito kung ano ang ginagawa ng CLI, paano ito i-on, at ang pangkalahatang pinakamahusay na kagawian sa likod nito (kapaki-pakinabang na higit pa sa proyektong ito).

Ang apat na mode

Mode Bandila Env Ano ang ginagawa nito
Screen reader --accessible (--a11y, --screen-reader) LOCKEDIN_ACCESSIBLE=1, o TERM=dumb Malinis na linear na plain text: walang border, walang ASCII art, walang spinner motion, walang decorative glyph; walang kulay; maikling prompt; semantic landmark ("Post:" … "(end of post)").
Mataas na contrast --high-contrast (--hc) LOCKEDIN_HIGH_CONTRAST=1 Isang high-contrast na palette para sa low vision: purong puting pangalawang text, mas maliwanag na mga accent, walang dim, solid na accent sa halip na ang low-contrast na gradient.
Mababang distraction --low-distraction (--calm, --reduce-motion) LOCKEDIN_LOW_DISTRACTION=1, LOCKEDIN_REDUCE_MOTION=1 Pinababang galaw (walang spinner animation), walang pandekorasyon na emoji, kalmadong solid na kulay — pinapanatili ang visual na layout. Para sa pinababang cognitive/sensory load.
Plain / monochrome --plain (--mono, --monochrome) LOCKEDIN_PLAIN=1, o NO_COLOR=1 Hindi pinapagana ang lahat ng kulay habang pinapanatili ang buong layout, mga hangganan, at emoji. Para sa mga terminal na may mahinang suporta sa kulay, pag-log, o kagustuhan. Mga override FORCE_COLOR.

Sila nag-compose: --high-contrast --low-distraction nagbibigay sa iyo ng maliwanag, mahinahon, walang emoji na UI; isang gumagamit ng screen-reader sa a TERM=dumb awtomatikong nakakakuha ng accessible mode ang terminal. Kapag magkasalungat ang mga mode, mas mahigpit ang mananalo — ang monochrome ay natalo sa isang color palette, at ang screen-reader mode ay pumapalit sa plain.

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

Paglipat ng mga mode sa loob ng isang session: /a11y

Hindi mo kailangang magdesisyon nang harapan. Sa loob ng interactive na session, ang /a11y Ang slash command ay isang tunay, gumaganang control panel (ang accessibility ay hindi ang satire):

Uri Resulta
/a11y Ipakita ang kasalukuyang estado (on/off) ng lahat ng apat na mode
/a11y <mode> I-toggle ang isa: screen-reader, high-contrast, low-distraction, plain (mga alias tulad ng sr / hc / calm / mono trabaho din)
/a11y reset I-off ang bawat mode

Ang estado ay palaging ipinapakita bilang isang tahasang naka-on/naka-off na salita, hindi kailanman nag-iisa ng kulay — ang mismong mga user na pinaglilingkuran nito ay maaaring hindi mapansin ang kulay. Ang panel ay ganap na naisalokal.

Ang pinakamahuhusay na kagawian sa likod nito

Ito ang mga prinsipyong inilapat namin — ang parehong mga prinsipyo ay nalalapat sa anumang terminal tool.

  1. Semantics over decoration. Isang screen reader ang nagbabasa ng mga character. Ang mga hangganan ng box-drawing ay nagiging "horizontal line, horizontal line..."; isang ASCII-art wordmark ay ingay. Pinapalitan ng accessible mode ang visual na istraktura ng mga salita: ang splash ay nag-aanunsyo ng "LockedIn CLI" bilang text, at nakakakuha ang mga card ng landmarks ("Post:", "(end of post)") para malaman ng mga user kung saan magsisimula at magtatapos ang isang block.
  2. Huwag umasa sa kulay o mga icon na nag-iisa. Ibig sabihin na dala lang ng kulay o isang emoji ay hindi nakikita ng ilang user. Panatilihing makabuluhan ang teksto nang walang kulay — hal. Ang "Connected with Ava" ay magiging maayos kapag nawala ang ✔.
  3. Magbigay ng mga alternatibong text / tanggalin ang ingay. Basahin nang malakas ang pandekorasyon na emoji ("📥" → "tray ng inbox"). Ang naa-access na mode ay nagtatanggal ng mga pandekorasyon na glyph at pinapanatili ang mga salita; Ang low-distraction ay tinanggal ang malakas na emoji ngunit pinapanatili ang layout para sa mga nakikitang user na gusto lang ng kalmado.
  4. Respect reduced motion. Animation (ang braille spinner) ay isang distraction at maaaring maging vestibular trigger. Mga naa-access at low-distraction mode hindi nag-a-animate — ipi-print nila ang status nang isang beses, statically. Sinasalamin nito ang web prefers-reduced-motion.
  5. Nag-aalok ng mataas na contrast. Ang pangalawang text na "muted grey" na low-contrast ay nabigo WCAG contrast para sa maraming user. Pinapalitan ito ng high-contrast mode para sa purong puti at nagpapatingkad ng mga accent.
  6. Bawasan ang cognitive load. Higit pa sa paningin, ang ilang mga user ay nangangailangan ng mas kaunti: mas kaunting pag-unlad, walang galaw, walang emoji. Iyan ay isang first-class mode dito, hindi isang nahuling pag-iisip.
  7. Igalang ang mga kombensiyon sa platform. Iginagalang na ng CLI ang NO_COLOR; ginagamot din nito TERM=dumb (kung ano ang ini-export ng maraming screen-reader at Emacs shell) bilang "maa-access", at nababasa LOCKEDIN_REDUCE_MOTION. Ang pag-detect sa mga kasalukuyang signal ng user ay mabilis na ginagawang mag-configure sila ng isa pang bagay.
  8. Gawin itong masusubok, at panatilihin itong nasubok. Nabubulok ang accessibility na wala sa test gate. Iginiit ng suite na ang naa-access na output ay may walang mga decorative glyph, na mayroong mga landmark, na pinapalitan ng mataas na contrast ang palette, at ang mababang-distraction ay nananatiling nakahanay sa hangganan — sa bawat wika.

Nabigo rin ang pag-format ng direksyon. Ang Arabic, Persian, Hebrew, at Urdu ay hindi naglalabas ng mga kontrol ng bidi maliban kung ang user ay tahasang nagtakda LOCKEDIN_BIDI=on para sa isang terminal na kilala na sumusuporta sa mga nakahiwalay; tinatanggal sila ng screen-reader mode kahit noon pa man. Walang TTY probe o terminal allowlist ang maaaring mag-override sa ligtas na default na iyon.

Paano ito binuo (para sa mausisa)

  • a11yFilter(s) strips decorative Unicode (box-drawing, block, geometric, technical, dingbats, braille, emoji) at nag-flush ng text sa kaliwa — inilapat sa lahat na output sa accessible mode.
  • emojiFilter(s) ay ang mas magaan na filter na low-distraction: inaalis lang nito ang malakas na emoji/mga simbolo at pinapanatili ang box-drawing, mga bala, arrow, at kulay ng ANSI, kaya nananatili ang visual na layout.
  • Ang bagay na may kulay C ay pinalitan sa isang high-contrast palette sa lugar; bumabalik ang mga gradient sa solidong accent kapag naka-on ang high-contrast o low-distraction. Ang Plain mode ay pinipilit ang bawat C walang laman ang entry (walang laman ang kulay, kahit sa ilalim FORCE_COLOR) habang iniiwan ang layout na hindi nagalaw.
  • renderSplash, ang spinner, renderPrompt, at card may semantic branches para sa accessible mode (plain text, no motion, landmarks).
  • Nabubuhay ang detection detectAccessible / detectHighContrast / detectLowDistraction / detectPlain; inilalapat ng entry point ang mga ito bago i-render. Ang nasa session /a11y utos (handleA11y + renderA11yStatus) i-toggle nang live ang parehong estado sa antas ng module.

Pinapanatili itong gumagana kapag nagdagdag ka ng feature

Ang tutorial review checklist ay may kasamang hakbang sa pagiging naa-access, at isa itong magandang ugali kahit saan:

Tumakbo lockedin --accessible <your command> at kumpirmahin na ito ay nagbabasa bilang malinis na plain text — walang mga bagong dekorasyong glyph na dumaan sa filter — at ang anumang bagong structured na bloke ay may palatandaan. Pagkatapos ay subukan --high-contrast, --low-distraction, at --plain (na dapat maglabas ng hindi mga code ng kulay ngunit panatilihin ang layout). Ang bagong text na nakikita ng user ay nangangailangan ng susi sa bawat bundle ng wika, kaya ang /a11y panel at tumulong na manatiling isinalin.


Satire. Hindi kaakibat sa LinkedIn. GPL-3.0-or-later.

📘 LockedIn CLI wiki

Tutorial

Reference


Satire · Sátira · 風刺. Not affiliated with LinkedIn. GPL-3.0-or-later.

Clone this wiki locally