Teknika HTML WCAG 2.2
H102Leiho modalak sortzea HTMLko dialog elementuarekin
Izen ofiziala W3Cn: Elkarrizketa-koadro modalak sortzea HTMLko dialog elementuarekin
Laburbilduz
Leiho modala orriaren gainean irekitzen den koadro bat da, eta gainerakoa blokeatzen du itxi arte. HTMLko dialog elementuarekin sortzen bada eta showModal() bidez irekitzen bada, nabigatzaileak berak kudeatzen du teklatuaren fokua. Horrela, eskuz egindako leihoen ohiko akatsak saihesten dira.
Zergatik da garrantzitsua
Teklatua edo pantaila-irakurgailu bat erabiltzen duenak behar du leihoa irekitzean fokua (teklatuak eragiten duen puntua) haren barrura sartzea. Behar du, halaber, atzeko orrira irten ezin izatea eta, leihoa ixtean, fokua hura ireki zuen botoira itzultzea.
Horietakoren batek huts egiten badu, pertsona galdu egiten da. Ezkutuko orrian zehar tabulatzen jarrai dezake, edo dokumentuaren hasieran gelditu leihoa itxi ondoren. dialog elementuarekin, nabigatzaileak egiten du hori guztia zure ordez.
Nola egiten da
- Jarri leihoaren edukia
<dialog>baten barruan, eta eman izenburu bataria-labelledbybidez. - Ireki
<button type="button">batetik,showModal()metodoarekin.show()metodoak leiho ez-modal bat irekitzen du, eta ez du gainerakoa blokeatzen. - Ixteko, erabili
<form method="dialog">baten barruko botoi bat, edo deituclose()metodoari. Nabigatzaileak fokua itzultzen dio leihoa ireki zuen botoiari. - Kontuan izan fokua foku hartzeko moduko lehen elementura joaten dela. Izenburura joatea nahi baduzu, jarri
tabindex="-1"eta kokatu kodean ixteko botoiaren aurretik. - Ez baliogabetu Esc teklarekin ixteko aukera; nabigatzaileak berez eskaintzen du.
Nola egiaztatu
- Ireki leihoa teklatuarekin: iritsi botoira Tab teklarekin eta sakatu Sartu edo zuriune-barra.
- Egiaztatu fokua leihora edo haren barruko elementu batera igarotzen dela.
- Sakatu Tab hainbat aldiz. Fokuak ez du atzeko orriko esteka edo botoietara iritsi behar.
- Itxi Esc teklarekin eta ixteko botoiarekin. Fokuak leihoa ireki zuen botoira itzuli behar du.
Adibidea
Albiste-buletinera harpidetzeko leiho modala.
<button type="button" id="abrir">Harpidetu buletinera</button>
<dialog id="boletin" aria-labelledby="tit-boletin">
<h2 id="tit-boletin" tabindex="-1">Albiste-buletina</h2>
<!-- harpidetza-formularioa -->
<form method="dialog">
<button>Itxi</button>
</form>
</dialog>
<script>
const boletin = document.getElementById('boletin');
document.getElementById('abrir')
.addEventListener('click', () => boletin.showModal());
</script>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko H102 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
HTML
Deskribapena
Webguneak garatzen dituztenek elkarrizketa-koadro modalak erabili ohi dituzte erabiltzailearen arreta orriaren eduki nagusiaren esparrutik kanpo dagoen zeregin bati lotutako informazio edo jarduera batean jartzeko. Elkarrizketa-koadro modalak markaketan eraiki daitezke ARIAren dialog funtzioaren eta hari lotutako atributuen bidez, edo HTMLko dialog elementuaren bidez. ARIAren lehen araua betetzeaz gain, HTMLko dialog elementuak hainbat abantaila ditu ARIAko baliokidearen aldean, nabigatzaileak hartzen baititu bere gain funtzio hauek:
- teklatuaren fokua irekitzen berri den
dialogmodalera mugitzen da; - teklatuaren fokua elkarrizketa-koadroa deitu zuen elementura itzultzen da (elementua orrian jarraitzen duela suposatuta)
dialogmodala ixten denean; - teklatuaren fokua
dialogmodalaren edukira eta nabigatzailearen beraren interfazera mugatzen da (hau da, nabigatzailearen erabiltzaile-interfaze espezifikora, hala nola helbide-barra, etab.); - elkarrizketa-koadro modaletik «kanpo» dagoen orriko edukia geldo bihurtzen da; horrela, laguntza-teknologientzat ezkutatuta eta erabiltzaile guztientzat erabilezin gelditzen da
dialogmodala irekita dagoen bitartean; - Escape tekla erabil daiteke
dialogmodala ixteko.
Teknika honek HTMLko dialog elementua erabiltzen du, neurrira egindako ARIA inplementazio baten ordez, eta horrek murriztu egiten du elkarrizketa-koadro modal irisgarri bat sortzeko behar den ahalegina.
Adibideak
Posta-zerrenda batera harpidetzeko elkarrizketa-koadro bat
Hau dialog elementu modal bat erabiltzeko adibide bat da, erabiltzaileari posta-zerrenda batera harpidetzeko formulario bat erakusteko. Orriaren zati nagusiak button elementu bat du, eta, aktibatzean, dialog modala deitzen du. button elementuak type atributua erabiltzen du nabigatzaileari adierazteko ez dela submit motako button bat.
dialog modala irekitzen denean, nabigatzaileak elkarrizketa-koadro modaletik kanpo dagoen eduki guztia geldotzat hartzen du; hala, erabilezin bihurtzen du eta laguntza-teknologientzat ezkutatzen du. Adibidez, pantaila-irakurgailu batek ezingo du eduki geldoaren zatirik ez iritsi ez iragarri. Gainera, orriko edukia geldoa denez, teklatuaren fokua dialog elementuaren barruan dauden foku hartzeko moduko elementuetara eta nabigatzailearen kontroletara bakarrik iritsi ahal izango da. Deitzean, nabigatzaileak automatikoki jartzen du fokua elkarrizketa-koadroaren DOMeko foku hartzeko moduko lehen elementuan. Adibide honetan, h1 elementuak jasoko du fokua, tabindex="-1" atributua duelako. Kontuan izan, dialog elementuaren ixteko button elementua bisualki h1 elementuaren aurretik agertzen bada ere, dialog elementuaren DOMeko azken elementua dela. button elementua lehena balitz, hark jasoko luke fokua elkarrizketa-koadroa irekitzean.
HTMLa
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,
initial-scale=1, shrink-to-fit=no">
<title>Turbo Encabulator News</title>
</head>
<body>
<main>
<h1>All The News About Turbo Encabulators</h1>
<button class="open-modal" type="button">Sign up to our mailing list!</button>
</main>
<dialog aria-labelledby="dialog-heading" id="mailing-list-dialog">
<h1 id="dialog-heading" tabindex="-1">Sign up to our mailing list</h1>
<form>
<p class="req-note">All form fields are required.</p>
<div>
<label for="fname">First Name</label>
<input aria-required="true" autocomplete="given-name" id="fname" type="text">
</div>
<div>
<label for="lname">Last Name</label>
<input aria-required="true" autocomplete="family-name" id="lname" type="text">
</div>
<div>
<label for="email">Email address</label>
<input aria-required="true" autocomplete="email" id="email" type="text">
</div>
<button class="sign-up" type="submit">Sign up</button>
</form>
<form method="dialog">
<button aria-label="close" class="close-modal">×</button>
</form>
</dialog>
</body>
</html>
CSSa
*, *::after, *::before {
box-sizing: inherit;
}
body {
background:#fff;
color:#000;
font:1rem/1.5 system-ui, Helvetica, Roboto, sans-serif;
}
*:focus-visible {
outline:1px solid #0054AE;
outline-offset:1px;
}
dialog {
border:1px solid #000;
padding:2rem;
position:relative;
}
dialog::backdrop {
background-color:hsla(0, 0%, 0%, .5);
}
.close-modal {
inset-block-start:1.5rem;
inset-inline-end:1.5rem;
line-height:1.3;
padding:0.25em 0.5em;
position:absolute;
}
.sign-up {
background:#000;
color:#fff;
padding:0.25em;
}
dialog h1 {
display:inline-block;
line-height:1.3333;
margin:0;
max-inline-size:95%;
}
form {
display:grid;
grid-gap:20px;
grid-template-columns:repeat(auto-fit, minmax(150px, 1fr));
}
.req-note, .sign-up {
grid-column:1 / -1;
}
label {
display:block;
}
input {
border:1px solid hsl(0, 0%, 50%);
font:inherit;
inline-size:calc(100% - 4px);
}
button {
background:#fff;
border:1px solid hsl(0, 0%, 50%);
border-radius:3px;
color:inherit;
font:inherit;
margin:0;
}
JavaScripta
Scripta beharrezkoa da dialog elementua deitzen denean erakusteko. HTMLko dialog elementua bi agindu desberdinekin ireki daiteke: show() (dialog ez-modaletarako) eta showModal() (dialog modaletarako); azken hori erabiltzen da adibide honetan.
Oharra: dialog elementua ixteko funtzio bat idatzi beharrean, ixteko botoia method="dialog" atributua duen form elementu independente baten barruan habiaratuta dago. Metodo horri esker, elkarrizketa-koadroa itxi egiten da botoi hori aktibatzean, eta nabigatzaileak hartuko du bere gain teklatuaren fokua hura deitu zuen elementuari itzultzea.
document.addEventListener("DOMContentLoaded", function(e){
const d = document.querySelector("dialog");
const btnOpen = document.querySelector(".open-modal");
btnOpen.addEventListener("click", function(){
d.showModal();
}, false);
});
Probak
Prozedura
- Aurkitu
dialogelementu modalak deitzen dituzten orriko osagaiak. - Egiaztatu
dialogbakoitza ireki daitekeela hura deitzen duen elementua teklatuarekin aktibatuta (adibidez,buttonbat aktibatzea Sartu tekla edo zuriune-barra sakatuta). dialogmodala irekitzen denean, egiaztatu fokua hartara edo foku hartzeko moduko haren ondorengoetako batera mugitu dela.dialogmodala irekita dagoen bitartean, egiaztatu teklatuaren fokua ezin dela dokumentu nagusiko elementuetara mugitu.dialogmodala ixten denean, egiaztatu fokua hura deitu zuen elementura itzultzen dela, elementu horrek orrian jarraitzen badu.
Espero diren emaitzak
- 2., 3., 4. eta 5. egiaztapenak egiazkoak dira.
Baliabideak
-
HTML:
dialogelementua. -
HTML:
buttonelementua. - ARIA Authoring Practices Guide - dialog (modal) pattern (elkarrizketa-koadro modalaren eredua).
- Using ARIA.
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren H102 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.