Accessibility eu

Irisgarritasuna

🌎 Hizkuntza: Euskara — ikusi 33 hizkuntzak

LockedIn CLI txantxa bat da, baina bere irisgarritasuna ez. Hain aberatsa den terminal-interfaze bat —gradientedun wordmarka, marren bidezko txartelak, braille-spinnerrak, emojiak— benetan zaila da laguntza-teknologiarekin erabiltzeko, hartarako diseinatzen ez baduzu. Orri honek azaltzen du zer egiten duen CLIak, nola aktibatu eta atzean dauden jardunbide egoki orokorrak (proiektu honetatik askoz haratago baliagarriak).

Lau moduak

Modua	Aukera	Ingurune-aldagaia	Zer egiten duen
Pantaila-irakurlea	--accessible (--a11y, --screen-reader)	LOCKEDIN_ACCESSIBLE=1, edo TERM=dumb	Testu lau lineal eta garbia: ertzik ez, ASCII-artik ez, spinner-mugimendurik ez, glifo apaingarririk ez; kolorea itzalita; prompt laburra; mugarri semantikoak («Posta:» … «(postaren amaiera)»).
Kontraste handia	--high-contrast (--hc)	LOCKEDIN_HIGH_CONTRAST=1	Ikusmen urrirako kontraste handiko paleta: bigarren mailako testu zuri-zuria, azentu distiratsuagoak, ilundurarik gabe, azentu solidoa kontraste baxuko gradientearen ordez.
Distrakzio baxua	--low-distraction (--calm, --reduce-motion)	LOCKEDIN_LOW_DISTRACTION=1, LOCKEDIN_REDUCE_MOTION=1	Mugimendu murriztua (spinner-animaziorik ez), emoji apaingarririk ez, kolore solido lasaia — diseinu bisuala mantentzen du. Karga kognitibo/sentsorial txikiagoarentzat.
Laua / monokromoa	--plain (--mono, --monochrome)	LOCKEDIN_PLAIN=1, edo NO_COLOR=1	Kolore guztia desaktibatzen du, diseinu osoa, ertzak eta emojiak mantenduz. Kolore-euskarri eskaseko terminaletarako, log-etarako edo lehentasunagatik. FORCE_COLOR gainditzen du.

Konbinatu egiten dira: --high-contrast --low-distraction erabilita interfaze distiratsu, lasai eta emojirik gabekoa lortzen duzu; TERM=dumb terminal batean dagoen pantaila-irakurleko erabiltzaileak modu irisgarria automatikoki jasotzen du. Moduek talka egiten dutenean, murriztaileenak irabazten du — monokromoak kolore-paleta bat gainditzen du, eta pantaila-irakurleko moduak modu laua ordezkatzen du.

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

Modua saio baten barruan aldatzea: /a11y

Ez duzu hasieratik erabaki behar. Saio interaktiboaren barruan, /a11y slash komandoa benetako kontrol-panel funtzional bat da (irisgarritasuna ez da satira):

Idatzi	Emaitza
/a11y	Erakutsi lau moduen uneko egoera (aktibatuta/desaktibatuta)
/a11y <modua>	Txandakatu bat: screen-reader, high-contrast, low-distraction, plain (sr / hc / calm / mono moduko aliasek ere balio dute)
/a11y reset	Itzali modu guztiak

Egoera beti aktibatuta/desaktibatuta hitz esplizitu gisa erakusten da, inoiz ez kolorez soilik — hau baliagarri zaien erabiltzaile berek kolorea igarri ezingo lukete. Panela guztiz lokalizatuta dago.

Atzean dauden jardunbide egokiak

Hauek dira aplikatu genituen printzipioak — berberak edozein terminal-tresnari aplikatzen zaizkio.

1. Semantika apaindura baino lehen. Pantaila-irakurle batek karaktereak irakurtzen ditu. Marren bidezko ertzak «marra horizontala, marra horizontala…» bihurtzen dira; ASCII-arteko wordmark bat zarata da. Modu irisgarriak egitura bisuala hitzez ordezkatzen du: splashak «LockedIn CLI» testu gisa iragartzen du, eta txartelek mugarriak hartzen dituzte («Posta:», «(postaren amaiera)») erabiltzaileek bloke bat non hasi eta amaitzen den jakin dezaten.
2. Inoiz ez fidatu kolorez edo ikonoz soilik. Kolorez edo emoji batez soilik adierazitako esanahia ikusezina da zenbait erabiltzailerentzat. Mantendu testua esanguratsu kolorea itzalita ere — adib. «Avarekin konektatuta» ondo irakurtzen da ✔ desagertu ondoren.
3. Eman testu-alternatibak / kendu zarata. Emoji apaingarriak ozenki eta luze irakurtzen dira («📥» → «sarrera-ontzia»). Modu irisgarriak glifo apaingarri hutsak kentzen ditu eta hitzak mantentzen; distrakzio baxuak emoji zaratatsuak kentzen ditu, baina diseinua mantentzen du lasaitasuna baino nahi ez duten erabiltzaile ikusleentzat.
4. Errespetatu mugimendu murriztua. Animazioa (braille-spinnerra) distrakzio bat da eta abiarazle bestibular bat izan daiteke. Modu irisgarriak eta distrakzio baxukoak ez dute animatzen — egoera behin inprimatzen dute, estatikoki. Honek webaren prefers-reduced-motion islatzen du.
5. Eskaini kontraste handia. Kontraste baxuko «gris apaldu» bigarren mailako testuak WCAG kontrastea huts egiten du erabiltzaile askorentzat. Kontraste handiko moduak zuri-zuriaz ordezkatzen du eta azentuak distiratsuago egiten ditu.
6. Murriztu karga kognitiboa. Ikusmenaz haratago, zenbait erabiltzailek gutxiago behar dute: apaindura gutxiago, mugimendurik ez, emojirik ez. Hori lehen mailako modu bat da hemen, ez azken orduko gehigarri bat.
7. Errespetatu plataformaren hitzarmenak. CLIak dagoeneko NO_COLOR errespetatzen du; halaber, TERM=dumb (pantaila-irakurle eta Emacs shell askok esportatzen dutena) «modu irisgarrira jo» gisa hartzen du, eta LOCKEDIN_REDUCE_MOTION irakurtzen du. Erabiltzaileak dituen seinaleak hautematea hobea da beste gauza bat konfiguratzera behartzea baino.
8. Egin probagarri, eta mantendu probatuta. Test-langan ez dagoen irisgarritasuna usteltzen da. Suiteak baieztatzen du irteera irisgarriak glifo apaingarririk ez duela, mugarriak presente daudela, kontraste handiak paleta ordezkatzen duela eta distrakzio baxuak ertzekin lerrokatuta jarraitzen duela — hizkuntza guztietan.

Norabide-formatuak ere modu seguruan huts egiten du. Arabierak, persierak, hebreerak eta urduerak ez dute bidi-kontrolik igortzen erabiltzaileak berariaz LOCKEDIN_BIDI=on ezartzen ez badu isolatzaileak onartzen dituela dakizun terminal batentzat; pantaila-irakurleko moduak orduan ere kentzen ditu. Ez TTY zunda batek ez terminal-zerrenda zuri batek ezin dute lehenetsi seguru hori gainditu.

Nola dagoen eraikita (jakin-minerako)

• a11yFilter(s) funtzioak Unicode apaingarria kentzen du (marrak, blokeak, geometrikoak, teknikoak, dingbat-ak, braillea, emojiak) eta testua ezkerrera lerrokatzen — irteera guztiari aplikatzen zaio modu irisgarrian.
• emojiFilter(s) distrakzio baxuko iragazki arinagoa da: emoji/ikur zaratatsuak baino ez ditu kentzen eta marrak, buletak, geziak eta ANSI kolorea mantentzen ditu, diseinu bisualak bizirik iraun dezan.
• C kolore-objektua kontraste handiko paleta batez ordezkatzen da bertan; gradienteak azentu solido batera jotzen dute kontraste handia edo distrakzio baxua aktibatuta dagoenean. Laua moduak C-ren sarrera guztiak hutsik behartzen ditu (kolorea guztiz itzalita, FORCE_COLOR pean ere) diseinua ukitu gabe utziz.
• renderSplash, spinnerra, renderPrompt eta card-ek adar semantikoak dituzte modu irisgarrirako (testu laua, mugimendurik ez, mugarriak).
• Hautematea detectAccessible / detectHighContrast / detectLowDistraction / detectPlain funtzioetan dago; sarrera-puntuak errenderizatu aurretik aplikatzen ditu. Saioko /a11y komandoak (handleA11y + renderA11yStatus) modulu-mailako egoera bera txandakatzen du zuzenean.

Funtzionatzen mantentzea funtzionalitate bat gehitzean

Tutorialaren berrikuspen-zerrendak irisgarritasun-urrats bat dauka, eta ohitura ona da edonon:

Exekutatu lockedin --accessible <zure komandoa> eta baieztatu testu lau eta garbi gisa irakurtzen dela — iragazkitik pasatzen den glifo apaingarri berririk gabe — eta egituratutako bloke berri orok mugarri bat duela. Ondoren, probatu --high-contrast, --low-distraction eta --plain (kolore-koderik ez du igorri behar, baina diseinua mantendu behar du). Erabiltzaileak ikusten duen testu berriak gako bat behar du hizkuntza-pakete bakoitzean, /a11y panela eta laguntza itzulita jarrai dezaten.

---

_{Satira. Ez dago LinkedInekin afiliatuta. GPL-3.0-or-later.}