DataGrid: accessibility

1. Pregled in namen

Stanje: stran za konsolidacijo — vsaka tu navedena lastnost ARIA/ tipkovnice je že dokumentirana na svoji namenski podstrani funkcije (načelo enotnega vira: ta stran povezuje, ne ponavlja).

Vsaka kategorija (razvrščanje, izbira, množična dejanja …) dokumentira svoje atribute ARIA in tipkovnične interakcije tam, kjer živi pripadajoča pogodba. Za pregled dostopnosti z bralnikom zaslona/tipkovnico pa potrebujete pregled čez celotno mrežo — kar natanko zagotavlja ta stran.

2. Predpogoji

Brez — čista konsolidacija obstoječih pogodb.

3. Koncepti

Dve plasti: statična semantika ARIA (vedno prisotna, npr. scope="col") in od stanja odvisna semantika ARIA (odvisno od aktivnega modela izbire/razvrščanja, npr. aria-sort).

4. Prvi koraki

Ne velja — ta stran je referenčni pregled, ne izvedljiv vodnik.

5. Uporaba

Za popoln pregled dostopnosti konkretne mreže: tabelo v odseku 6 primerjajte z dejansko nastavljenimi $opts, nato odsek 7 (tipkovnica) z aktivnim modelom izbire.

6. Referenca API: pregled atributov ARIA

Atribut	Kdaj nastavljen	Dokumentirano v
`role=„grid“`	Na `<table>`, takoj ko je aktiven model izbire	osnove → ustvarjene oznake
`aria-multiselectable=„true“`	Pri `selection => 'multi'`	selection → večkratna izbira
`aria-label` (na tabeli)	Iz `$opts['ariaLabel']`, ko je nastavljen	osnove → $opts
`aria-sort` (na `<th>`)	Na trenutno razvrščenem, razvrstljivem stolpcu	sorting → na strani odjemalca
`aria-selected` (na `<tr>`)	Takoj ko je aktiven model izbire, sledi izbiri	selection → večkratna izbira
`aria-label` na celicah s potrditvenimi polji	Potrditveno polje glave in vsako potrditveno polje vrstice posebej označeno	selection → večkratna izbira
`role=„toolbar“` + `aria-label`	Orodna vrstica izbire (`.wk-datagrid__bulkbar`)	množična dejanja → bulkActions
`scope="col"` (na vsakem `<th>`)	Vedno — izrecna semantika glave stolpca za bralnike zaslona	`helper/widgets.php`
`aria-live="polite"` na števcu vrstice množičnih dejanj	Vedno, takoj ko se izriše vrstica množičnih dejanj — spremembe izbire se samodejno napovedo uporabnikom bralnikov zaslona	`helper/widgets.php` (`.wk-datagrid__bulkcount`)

7. Parametri, opcije in stanja: model tipkovnične interakcije

Tipka	Učinek	Predpogoj
Puščice	Premakne aktivno vrstico (roving tabindex)	Vsak model izbire
Preslednica	Preklopi izbiro aktivne vrstice	`selection => 'multi'`
Shift+puščica	Razširi obseg izbire	`selection => 'multi'`
Ctrl+A	Izbere vse vidne vrstice	`selection => 'multi'`
Ctrl+C	Kopira izbrane vrstice (vrstico za vrstico, ločeno z `\n`; brez izbire aktivno vrstico)	`selection => 'single'` ali `'multi'`
Klik na gumb glave stolpca	Razvrsti na strani odjemalca	`sortable !== false`, brez `sortUrl`

8. Popolni primeri

Podrobnosti, ustreznice z miško in robni primeri so izključno na pripadajočih straneh funkcij (stolpec „dokumentirano v„ v odseku 6 napotuje tja).

9. Omejitve in robni primeri

Brez, razen tistih, dokumentiranih na straneh funkcij.

10. Dostopnost in združljivost

[Live] napoved aria-live ob spremembi izbire: števec vrstice množičnih dejanj .wk-datagrid__bulkcount nosi aria-live="polite" (vir: helper/widgets.php) — dovolj vljudno, da ne prekine tekočega vnosa s tipkovnico, a dovolj zanesljivo, da uporabniki bralnikov zaslona samodejno slišijo vsako spremembo izbire.

11. Odpravljanje težav

Simptom: bralnik zaslona ne napove sprememb izbire.

Vzrok: starejša različica vtičnika brez tega atributa, ali prilagojene oznake, ki niso bile izrisane prek samega dataGrid().

Rešitev: preverite različico vtičnika; pri prilagojenih oznakah ročno dodajte aria-live="polite" k elementu števca.

12. Sorodne teme

predstavitveni pregled — vse kategorije
DataGrid: selection — popoln model interakcije izbire
DataGrid: sorting — popoln model interakcije razvrščanja