Addaw, joan hasierara Egin dohaintza

6. ikasgaia (10 guztira) · 14 min irakurtzeko · Berrikuspen-data: 26/10/2026

JavaScript irisgarria: gertaerak, testuinguru-aldaketak, denbora-mugak eta eduki dinamikoa

Ikasgai ireki bat irakurtzen ari zara. Matrikulatu doan testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.

HTMLak semantika ematen du, eta CSSk aurkezpena; JavaScriptek erabakitzen du zer gertatzen den eta noiz. Hor agertzen dira inongo etiketak zuzentzen ez dituen arazoak: askatzean beharrean sakatzean abiarazten diren ekintzak, abisatu gabe orriz aldatzen duten goitibeherakoak, izapide baten erdian iraungitzen diren saioak, eta fokua eramanez ordezten den edukia. Ikasgai honek programatutako portaeraren mende dauden irizpideak biltzen ditu (2.5.2 Erakuslearen ekintza bertan behera uztea, 3.2.1 Fokua jasotzean, 3.2.2 Datuak sartzean eta 2.2.1 Denbora doigarria), baita agertzen eta desagertzen den edukia kudeatzeko teknikak ere. Hurrengo ikasgaiaren oinarria da; hartan, hori guztia orri bakarreko aplikazioei nola aplikatzen zaien ikusiko duzu.

Gertaerak: entzun asmoari, ez gailuari

Elementu natibo baten click gertaera da dagoen inklusiboena: saguarekin abiarazten da, pantailan ukituta, Sartu teklarekin edo zuriune-barrarekin, ahots bidezko kontrolarekin, sakagailu batekin eta pantaila-irakurgailuen aktibazio-keinuekin. Horregatik, click kudeatzailea duen <button> batek ez du beste ezer behar erabilgarria izateko.

Behe-mailako gertaerak (mousedown, pointerdown, touchstart) beste kontu bat dira. 2.5.2 Erakuslearen ekintza bertan behera uztea (A) irizpideak eskatzen du erakusle bakarrarekin erabiltzen den funtzionaltasunerako baldintza hauetako bat gutxienez betetzea: sakatzean ezer ez exekutatzea (beheranzko gertaera); ekintza askatzean osatzea eta askatu aurretik erakuslea aldenduta bertan behera utzi ahal izatea, edo ondoren desegin; askatzean sakatzeak egindakoa desegitea; edo sakatzean jardutea funtsezkoa izatea (piano birtual baten teklak). Damutu ahal izatea da kontua, dardarak dituenarentzat ezinbestekoa den zerbait.

Adibidea

// Okerra: sakatu bezain laster ezabatzen du, bertan behera uzteko aukerarik gabe,
// eta ez du teklatuarekin funtzionatzen
filaBorrar.addEventListener('mousedown', () => eliminarExpediente(id));

// Zuzena: click askatzean abiarazten da (baita teklatuarekin ere); erakuslea
// botoitik ateratzen bada askatu aurretik, ez da ezer gertatzen
botonBorrar.addEventListener('click', () => eliminarExpediente(id));

Arrastatu eta jaregitea da «hartzeko» sakatzearen kasu zilegia: betetzen du, ekintza askatzean osatzen delako eta helmugatik kanpo askatuta bertan behera geratzen delako. Hala ere, arrastatu gabeko alternatiba bat behar du, osagaien ikastaroan 2.5.7 Arrastatze-mugimenduak irizpidearekin ikusi zenuen bezala.

Gertaera-kudeatzaileetarako beste arau batzuk:

  • Kontrol pertsonalizatu baterako teklatua programatzen baduzu, erabili keydown eta event.key propietatea ('Enter', ' ', 'Escape', 'ArrowDown'); keypress eta keyCode zaharkituta daude.
  • Ez harrapatu teklak modu orokorrean beharrik gabe: pantaila-irakurgailuek eta luzapenek asko erabiltzen dituzte. Tekla bakarreko laster-teklak gehitzen badituzu, desaktibatu edo berriro esleitu ahal izan behar dira, edo fokua osagaian dagoenean bakarrik funtzionatu (2.1.4 Karaktere bakarreko laster-teklak, teklatuaren ikastaroan ikusia).
  • mouseenter edo mouseover-ekin egiten duzun guztiak bere baliokidea izan behar du focus edo focusin-ekin.

Testuinguru-aldaketak: 3.2.1 eta 3.2.2

WCAGek bereizi egiten dituzte eduki-aldaketa eta testuinguru-aldaketa. Testuinguru-aldaketa bat aldaketa garrantzitsu bat da, eta, pertsonak espero ez duenean gertatzen bada, desorientatu egiten du: leiho berri bat irekitzea, beste orri batera nabigatzea, fokua beste toki batera eramatea edo edukia orriaren zentzua aldatzeko moduan aldatzea. Orri bereko emaitza-zerrenda bat iragaztea eduki-aldaketa bat da; beste orri batera eramatea, testuinguru-aldaketa bat.

  • 3.2.1 Fokua jasotzean (A): elementu batek fokua jasotzeak ez du testuinguru-aldaketarik eragin behar. Akats tipikoak: eremu bat fokuratzean leiho gainerakor bat irekitzea, botoi batera iristean formularioa bidaltzea, tabulatzean fokua beste toki batera jauzi egitea.
  • 3.2.2 Datuak sartzean (A): kontrol baten balioa aldatzeak (aukera bat hautatzea, lauki bat markatzea, idaztea) ez du automatikoki testuinguru-aldaketarik eragin behar, aurretik abisatu ez bada behintzat.

Ohiko akatsa

<!-- Okerra: aukera bat hautatzeak berehala nabigatzen du -->
<label for="idioma">Hizkuntza</label>
<select id="idioma" onchange="location.href = this.value">…</select>

<!-- Zuzena: pertsonak aukeratu eta berresten du -->
<form action="/cambiar-idioma">
  <label for="idioma">Hizkuntza</label>
  <select id="idioma" name="idioma">…</select>
  <button type="submit">Aldatu hizkuntza</button>
</form>

Nabigatzaile askotan, teklatuarekin, select itxi baten aukerak gezi-teklekin korritzean, aukera bakoitzak change abiarazten du: «Castellano»-tik «Valencià»-ra pasatu nahi zuena «Català»-n amaitzen du, hura aukeratu gabe. Gauza bera gertatzen da kode baten azken digitua idaztean bere kasa bidaltzen den formularioarekin.

Aurretik abisatzeak («Probintzia bat aukeratzean, haren ordezkaritzaren orria kargatuko da») irizpidea betetzea eragiten du, baina irtenbiderik sendoena pertsonak botoi batekin berrestea da. Eduki-aldaketak, berriz, berehalakoak izan daitezke; jakinarazi besterik ez da egin behar, adibidez «23 emaitza» idatziz role="status" eskualde batean, ARIAren ikastaroan ikusi zenuen bezala.

Denbora-mugak: iraungitzen diren saioak

Egoitza elektronikoek, lineako bankuek eta ordainketa-pasabideek saioa ixten dute jarduerarik ezagatik. Zilegi da, baina 2.2.1 Denbora doigarria (A) irizpideak eskatzen du denbora-muga bakoitzerako aukera bat gutxienez betetzea: pertsonak hura desaktibatu ahal izatea; haren iraupenaren gutxienez hamar halakora doitu ahal izatea; edo iraungi aurretik abisu bat jasotzea, gutxienez 20 segundo izatea ekintza erraz batekin luzatzeko (adibidez, tekla bat sakatuz) eta gutxienez hamar aldiz luzatu ahal izatea. Salbuetsita daude denbora errealeko gertaerak (enkante bat), muga funtsezkoak (denbora neurtutako azterketa bat) eta 20 ordu gainditzen dituztenak.

Sakagailu bat edo pantaila-irakurgailu bat erabiltzen duenak, edo irakurtzeko denbora gehiago behar duenak, hainbat aldiz gehiago behar dezake. 15 minutuko saio baterako inplementazio bat:

const DURACION = 15 * 60 * 1000;
const AVISO_ANTES = 2 * 60 * 1000;
let temporizador;

function programarAviso() {
  clearTimeout(temporizador);
  temporizador = setTimeout(mostrarAviso, DURACION - AVISO_ANTES);
}

function mostrarAviso() {
  // Elkarrizketa-koadro modala (role="alertdialog"), fokua «Luzatu saioa»-n duela
  dialogoSesion.showModal();
  botonAmpliar.focus();
}

botonAmpliar.addEventListener('click', async () => {
  await renovarSesionEnServidor();
  dialogoSesion.close();
  programarAviso();
});

Izapide luzeetan aldea markatzen duten bi osagarri AAA: 2.2.5 Berriro autentifikatzea (saioa iraungitzen bada, berriro identifikatzean datuak galdu gabe jarraitzen da) eta 2.2.6 Denbora-mugak (zenbat jarduerarik ezak eragiten duen datuen galera abisatzea, 20 ordu baino gehiago gordetzen ez badira behintzat). Formularioaren zirriborro bat gordetzeak biak betetzen laguntzen du, eta ordu erdiko lana galtzea saihesten du.

Agertzen, desagertzen edo ordezten den edukia

JavaScriptek DOMa aldatzen duen bakoitzean, bi gauza galdetu behar dira: non geratzen den fokua eta nola jakiten duen pantaila ikusten ez duenak.

  • Txertatu eduki berria DOMan bere abiarazlearen ondoren, hain zuzen: akordeoi baten panela, «Erakutsi gehiago»-ren testua, aukera bat markatzean agertzen diren eremuak. Horrela, hurrengo Tab-a hartara iristen da. body-aren amaieran gehitzen baduzu, inork ez du aurkituko.
  • «Kargatu gehiago» botoia: kargatu ondoren, eraman fokua elementu berrietako lehenengora, edo utzi fokua botoian eta iragarri «Beste 10 emaitza kargatu dira» egoera-eskualde batean.
  • Ezabatutako elementua: fokua zuen elementua desagertzen bada (ezabatu berri den errenkada, beste batekin ordezten den botoia), fokua body-ra erortzen da, eta pertsona orriaren hasierara itzultzen da. Eraman fokua toki logiko batera hura ezabatu aurretik: zerrendako hurrengo elementura, aurrekora azkena bazen, edo zerrendaren izenburura hutsik geratu bada.
  • Irismenetik kanpo geratu behar duen edukia: inert atributuak, gaur egungo nabigatzaile guztiek onartzen dutenak, bloke bat ez fokugarri bihurtzen du eta laguntza-teknologietara iristea eragozten du. Ezin hobea da pantailatik kanpo animatzen den alboko menu itxi baterako (display: none-k trantsizioa eragotziko luke hor) edo orriaren gainerakorako geruza propio bat erakusten den bitartean. showModal()-ekin irekitako <dialog> natiboak berez bihurtzen du inerte gainerakoa.
function alternarMenu(abierto) {
  menuLateral.inert = !abierto;
  menuLateral.classList.toggle('abierto', abierto);
  botonMenu.setAttribute('aria-expanded', String(abierto));
  if (abierto) menuLateral.querySelector('a, button')?.focus();
  else botonMenu.focus();
}

Fokua mugitzea eskatzen ez duten iragarpenetarako, erabili kargatzen denetik dauden eskualde biziak, eta itxaron pertsonak idazteari utzi arte zuzeneko bilaketa baten emaitzak iragarri aurretik (500 milisegundo inguru), sakatze bakoitza ez eteteko.

Probatu zuk zeuk

Ireki garapen-tresnen kontsola zerrenda editagarriak dituen web-aplikazio batean eta idatzi: document.addEventListener('focusin', () => console.log(document.activeElement)). Nabigatu teklatuarekin, ezabatu elementu bat edo itxi panel bat, eta begiratu kontsolari. Ondoren, idatzi document.activeElement: body erantzuten badu, fokua galdu egin da eta akats bat aurkitu duzu.

Funtsezko puntua

Programatu ekintzak click-ekin elementu natiboetan, ez aldatu testuingurua fokuratzean ezta balio bat aldatzean ere, abisatu eta utzi edozein denbora-muga luzatzen, eta, DOMa aldatzen den bakoitzean, erabaki non geratzen den fokua eta nola jakinarazten den aldaketa.

Laburpena

  • Erabili click elementu natiboetan; ekintzak mousedown edo pointerdown-en exekutatzeak ez du 2.5.2 betetzen, bertan behera utz badaitezke edo funtsezkoa bada salbu.
  • Elementu bat fokuratzeak ezin du testuingurua aldatu (3.2.1), eta balio bat aldatzeak ere ez aurretiazko abisurik gabe (3.2.2): gehitu berresteko botoi bat.
  • Iraungitzen den saio orok aurretik abisatu behar du eta gutxienez 20 segundorekin eta ekintza erraz batekin luzatzen utzi (2.2.1); gorde datuak.
  • Txertatu edukia bere abiarazlearen ondoren, kokatu berriro fokua elementuak ezabatu aurretik, eta erabili inert irismenetik kanpo geratu behar duenerako.

Ikastaro honetako 4 ikasgai irakurri dituzu: ez itzazu galdu

Sortu zure kontua doan, gorde irakurri duzuna eta jarraitu ikastaroarekin, osorik:

  • Ikasgai honetako testa (3 galdera), ikasitakoa egiaztatzeko
  • Benetako orriekin egindako ariketa praktikoak
  • Zure aurrerapena gordeta: utzi zenuen lekutik jarraituko duzu, edozein gailutatik
  • Ikastaroaren egiaztagiria, orduekin, eta 3. mailako doako ziurtagiria azterketa gainditzen duzunean

Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.