Addaw, joan hasierara Egin dohaintza

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

SPAak (React, Vue, Angular): bideratzea, fokua, iragarpenak eta izenburuak

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

Orri bakarreko aplikazio batek (SPA) edukia aldatzen du dokumentua berriro kargatu gabe. Horrek hautsi egiten ditu nabigatzaile batek karga bakoitzean berez egiten zituen hiru gauzak: fokua hasieran jartzea, orri berriaren izenburua iragartzea eta goitik irakurtzen hastea. Gainera, frameworkek erraztu egiten dute interfaze osoak div eta gertaera-kudeatzaileekin eraikitzea, eta haien abstrakzioek (osagaiak, txantiloiak, atariak) beren tranpak gehitzen dituzte. Ikasgai honek edozein SPAtan ebatzi behar dena biltzen du, baita nola egiten den Reacten, Vuen eta Angularren ere.

Bide-aldaketa bakoitzean ebatzi behar dena

  1. Izenburua: document.title eguneratzea ikuspegiaren izenburuarekin (2.4.2).
  2. Fokua: ikuspegi berriaren hasierara eramatea, normalean tabindex="-1" duen <h1>-era (2.4.3); horrela, irakurgailuak izenburua iragartzen du, eta hurrengo Tab-a edukian hasten da. Gida batzuek nahiago dute <main> edukiontzia edo saltatzeko esteka bat fokuratzea; garrantzitsuena da koherentea izatea eta pertsonak jakitea orriz aldatu dela.
  3. Iragarpena: aukeran, «Orria kargatuta: Nire espedienteak» idaztea role="status" eskualde orokor batean (4.1.3).
  4. Scrolla: gora itzultzea, bideratzaileek aurreko posizioa mantendu ohi dutelako.
  5. Karga-egoera: ikuspegiak denbora behar badu, «Kargatzen…» erakustea egoera-eskualdean eta aria-busy="true" edukiontzian datuak iritsi arte; amaitzean, fokua mugitzea.

Aurreko ikastaroetan (HTML semantikoa, formularioak, teklatua, ARIA, osagaiak) eta ikastaro honetako JavaScript ikasgaian ikusi genuen gainerako guztia berdin aplikatzen da framework baten osagai baten barruan; frameworkak ez du zure ordez egiten, ezta eragozten ere.

Infografia · Prozesua

Zer egin SPA baten bide-aldaketa bakoitzean

Bost urrats nabigatzaileak orri bat kargatzean berez egiten zuena berreskuratzeko

  1. 1. urratsa: Itxaronaldia adierazi«Kargatzen…» egoera-eskualdean eta aria-busy edukiontzian
  2. 2. urratsa: Izenburua eguneratudocument.title ikuspegiaren eta webgunearen izenarekin (2.4.2)
  3. 3. urratsa: Gora itzuliScrolla hasierara: bideratzaileek aurreko posizioa gordetzen dute
  4. 4. urratsa: Fokua mugitutabindex="-1" duen h1-era: iragarri egiten da, eta hurrengo Tab-ak edukian jarraitzen du
  5. 5. urratsa: Aldaketa iragarri«Orria kargatuta: …» role="status" duen eskualde iraunkor batean (4.1.3)
ADDAW · Irisgarritasun-ikastaroak
Irakurri infografia testu gisa

Orri bakarreko aplikazio batek bide-aldaketa bakoitzean exekutatu behar duen bost urratseko prozesua. 1. urratsa, itxaronaldia adieraztea: «Kargatzen…» erakustea egoera-eskualdean eta aria-busy jartzea edukiontzian. 2. urratsa, izenburua eguneratzea: document.title ikuspegiaren eta webgunearen izenarekin, 2.4.2 irizpidearen arabera. 3. urratsa, gora itzultzea: hasierara scroll egitea, bideratzaileek aurreko posizioa gordetzen dutelako. 4. urratsa, fokua mugitzea: tabindex -1 duen h1-era, iragar dadin eta hurrengo Tab-ak eduki berrian jarrai dezan. 5. urratsa, aldaketa iragartzea: «Orria kargatuta» eta ikuspegiaren izena idaztea role status duen eskualde iraunkor batean, 4.1.3 irizpidearen arabera.

React

React Routerrek ez du fokua kudeatzen, eta, haren metadatu-funtzioak erabiltzen ez badituzu, izenburua ere ez. Ohiko irtenbidea bide bakoitzean muntatzen den osagai bat da, edo kokapen-aldaketei entzuten dien efektu bat:

Adibidea

import { useEffect, useRef } from 'react';
import { useLocation } from 'react-router-dom';

export function Pagina({ titulo, children }) {
  const h1 = useRef(null);
  const { pathname } = useLocation();
  useEffect(() => {
    document.title = `${titulo} - Egoitza elektronikoa`;
    window.scrollTo(0, 0);
    h1.current?.focus();
  }, [pathname, titulo]);
  return (
    <main id="contenido">
      <h1 ref={h1} tabIndex={-1}>{titulo}</h1>
      {children}
    </main>
  );
}

Aplikazioaren lehen kargan ez da beharrezkoa fokua mugitzea, nabigatzailea dokumentuaren hasieratik hasten delako jada: hori errespetatu nahi baduzu, saltatu efektua lehen errendatzean eta aplikatu ondorengo bide-aldaketetan bakarrik.

Irisgarritasunari eragiten dioten Reacten berezitasunak:

  • Atributua htmlFor da for-en ordez, eta tabIndex tabindex-en ordez; aria-* eta role atributuak HTMLn bezala idazten dira.
  • Osagai berrerabilgarrien identifikatzaileak useId()-rekin sortu behar dira, label/for eta aria-labelledby hausten dituzten id bikoiztuak saihesteko.
  • Atariek (createPortal) modalak body-aren amaieran kokatzen dituzte: fokua esplizituki kudeatu behar da, eta aplikazioaren gainerakoa inerte bihurtu behar da.
  • Eskualde biziek modu iraunkorrean muntatuta egon behar dute (layout-ean), ez baldintzapean errendatuta mezua barruan dutela.
  • Irisgarritasun-oinarri ona duten liburutegiak: React Aria (Adobe), Radix Primitives, Headless UI. Saihestu teklatuarekiko euskarria dokumentatzen ez duten osagai-liburutegiak.

Vue

Vue Routerrek nabigazio-guardak (router.afterEach) eta bide bakoitzaren meta erakusten ditu, eta azken hori leku ona da izenburua jartzeko:

router.afterEach((to) => {
  document.title = `${to.meta.titulo} - Egoitza elektronikoa`;
  nextTick(() => {
    const h1 = document.querySelector('main h1');
    h1?.setAttribute('tabindex', '-1');
    h1?.focus();
    anunciar(`Orria kargatuta: ${to.meta.titulo}`);
  });
});

Vueren xehetasunak: v-if-ek elementua DOMetik ezabatzen du (display:none-ren baliokidea da); v-show-k, berriz, CSSrekin ezkutatzen du (hura ere irisgarritasun-zuhaitzetik kanpo); bietako batek ere ez du eduki mamurik uzten, baina v-if-ek osagaiak suntsitu eta berriro sortzen ditu, eta horrek fokua galarazi dezake. <Transition>-en trantsizioek prefers-reduced-motion errespetatu behar dute. id bakarretarako, Vue 3.5ek useId() dakar; aurreko bertsioetan, sortu identifikatzaile bat instantzia bakoitzeko. Liburutegiak: Vuetifyk euskarri onargarria du; Headless UIk eta Reka UIk (lehen Radix Vue) primitiba irisgarriak eskaintzen dituzte.

Angular

Angular da tresna gehien dakartzan frameworka berez, CDKaren (Component Dev Kit) @angular/cdk/a11y moduluaren bidez:

  • LiveAnnouncer: eskualde bizi orokor batean idazteko zerbitzua, hura eskuz sortu gabe: this.announcer.announce('Orria kargatuta: Nire espedienteak', 'polite').
  • FocusTrap eta cdkTrapFocus direktiba: fokuaren zikloa elkarrizketa-koadroen barruan.
  • FocusMonitor: fokua teklatuz, saguz edo programaz iritsi den hautematen du; erabilgarria da foku-adierazle pertsonalizatuetarako.
  • ListKeyManager eta FocusKeyManager: roving tabindex-a eta gezi-teklen bidezko nabigazioa inplementatzen dituzte zerrenda, menu eta fitxetarako.
  • InteractivityChecker: elementu bat fokugarria edo tabulagarria den egiaztatzen du.
this.router.events
  .pipe(filter((e) => e instanceof NavigationEnd))
  .subscribe(() => {
    this.title.setTitle(`${this.rutaActual.titulo} - Egoitza elektronikoa`);
    const h1 = document.querySelector('main h1') as HTMLElement | null;
    h1?.setAttribute('tabindex', '-1');
    h1?.focus();
  });

@angular/platform-browser-eko Title zerbitzuak izenburua kudeatzen du, eta, Angular 14tik aurrera, bide bakoitzaren definizioko title propietateak automatikoki eguneratzen du. Angular Materialek CDKa erabiltzen du barnean, eta haren osagaiek (elkarrizketa-koadroak, menuak, fitxak) irisgarritasun-oinarri sendoa dute, nahiz eta beti egiaztatu behar diren zuk ematen dituzun izen irisgarriak.

Ohiko akatsa

«Osagai-liburutegia irisgarria da» pentsatzean konfiantza jartzea. Liburutegi batek foku-ziklo ezin hobea duen elkarrizketa-koadro bat eman dezake, baina zuk izenbururik pasatzen ez badiozu, elkarrizketa-koadroak ez du izenik; zure fitxak ikono bat bakarrik badu, ez du izenik; osagaia <a> baten barruan errendatzen baduzu, elementu elkarreragileak habiaratzen dituzu. Liburutegiak eredua ebazten du; edukia eta integrazioa erabiltzen duenaren ardura dira.

SPAen zeharkako arazoak

  • div-ekin egindako botoiak: frameworkek edozein gauzari onClick jartzeko aukera ematen dute, eta diseinu-sistema propioek gehiegi erabiltzen dute. ARIAren 1. arauak indarrean jarraitzen du.
  • Formulario kontrolatuak: denbora errealean teklaz tekla balioztatzea, egoera erreaktiboarekin hain erraz inplementatzen dena, oldarkorra da; balioztatu eremutik irtetean edo bidaltzean.
  • Karga alferra eta eskeletoak: kargako skeleton-ak eduki hutsa dira irakurgailuarentzat; lagundu aria-busy-rekin eta egoera-mezu batekin.
  • Scroll infinitua: orrikatzerik edo «Kargatu gehiago» botoirik gabe, orri-oina iritsiezin gera daiteke, eta irakurgailua ez da inoiz amaierara iristen. Eskaini beti botoi bat.
  • Zerbitzarian errendatzea eta hidratazioa: hasierako HTMLak zuzena izan behar du jada (landmark-ak, izenburuak), hori baita irakurgailuak jasotzen duena JavaScriptek kontrola hartu aurretik.

Funtsezko puntua

Layout osagai bat, bide-aldaketa bakoitzean izenburua eguneratzen duena, <h1>-a fokuratzen duena, gora scroll egiten duena eta karga iragartzen duena, gehi egoera-eskualde iraunkor bat eta instantzia bakoitzeko id bakarrak: horrekin, SPA batek nabigatzaileak berez egiten zuena berreskuratzen du. Gainerako guztia HTMLa, teklatua eta ARIA da, beste edozein webgunetan bezala.

Laburpena

  • Bide-aldaketa bakoitzean: document.title, fokua tabindex="-1" duen <h1>-era, scrolla gora eta, hala badagokio, iragarpena egoera-eskualde batean.
  • React: useEffect useLocation-ekin, useId id-etarako, atariak fokuaren kudeaketarekin, eskualde biziak beti muntatuta.
  • Vue: router.afterEach nextTick-ekin, meta.titulo, kontuz v-if-ekin eta fokuaren galerarekin.
  • Angular: CDK a11y (LiveAnnouncer, FocusTrap, FocusKeyManager) eta bideen title propietatea.
  • Liburutegiak eredua ebazten du, baina izenak, edukia eta integrazioa zure ardura izaten jarraitzen dute.

Baliagarria izan zaizu ikasgai hau?

Sortu zure kontua doan, 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.