8. ikasgaia (10 guztira) · 14 min irakurtzeko · Berrikuspen-data: 26/10/2026
Osagai berrerabilgarriak eta Web Components: API irisgarria, semantika eta Shadow DOMa
Ikasgai ireki bat irakurtzen ari zara. Matrikulatu doan testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.
Aurreko ikasgaian, irisgarritasuna aplikazio-eskalan ebatzi zenuen: bideak, izenburuak eta fokua. Honek gaur egun interfazeak eraikitzeko erabiltzen den adreilura jaisten du: osagai berrerabilgarrira. Ondo paketatutako botoi, eremu edo txartel batek irisgarritasuna errepikatzen du pantaila bakoitzean; gaizki paketatuta, errorea ehun aldiz errepikatzen du. Ez dira elkarreragin-ereduak (fitxak, menuak, elkarrizketa-koadroak), osagai elkarreragileen ikastaroan ikusi zenituenak, baizik eta osagaia nola programatzen den haren erabilera irisgarria bide erraza izan dadin: haren APIa, haren markaketa eta, Web Componentsen kasuan, Shadow DOMarekin duen harremana.
Diseinatu APIa irisgarria dena erraza izan dadin
Osagai baten APIa onartzen dituen propietateak dira. Izen irisgarria aukerakoa bada, norbaitek ahaztu egingo du. Egin derrigorrezko, eta utzi mota-sistemari eska dezan:
Adibidea
type BotonIconoProps = {
icono: React.ReactNode;
etiqueta: string; // derrigorrezkoa: hura gabe ez da konpilatzen
onClick: () => void;
};
export function BotonIcono({ icono, etiqueta, onClick }: BotonIconoProps) {
return (
<button type="button" onClick={onClick}>
<span aria-hidden="true">{icono}</span>
<span className="visually-hidden">{etiqueta}</span>
</button>
);
}
<BotonIcono icono={<Papelera />} onClick={borrar} /> etiqueta gabe erabiltzen duenak TypeScript errore bat jasotzen du editorean, edozein auditoria baino askoz lehenago.
Irisgarritasunean eragin zuzena duten beste API-erabaki batzuk:
- Semantika erabileraren arabera: osagaiak
hrefjasotzen badu,<a>bat errenda dezala; ekintza bat jasotzen badu,<button type="button">bat. Beti<button>margotzen duen etaonClick-ekin nabigatzen duen «Botoia» osagai bakar batek testuinguru-menua, «ireki fitxa berrian» aukera eta «esteka» iragarpena hausten ditu. - Izenburu-maila konfiguragarriak:
<h3>bat finkatzen duen txartel batek hierarkia hautsiko du beste orri batean erabili bezain laster. Onartunivelpropietate bat, lehenetsitako balio zentzuzko batekin. - Elementu zuzenera iristen diren atributuak:
id,aria-describedby,aria-invalidedoautocompletebenetako<input>-ari aplikatu behar zaizkio, ez hura biltzen duendiv-ari. - Elementurako sarbidea: osagai gurasoak kontrola fokuratu ahal izan behar du (fokua errore batera eramateko edo elkarrizketa-koadro bat ixtean itzultzeko). Reacten
forwardRef-ekin erakusten da, edo, React 19tik aurrera,refbeste propietate bat bezala jasoz; Vuen, txantiloi-erreferentziekin etadefineExpose-rekin; Angularren,ElementRef-ekin eta ikuspegi-kontsultekin. - Edukia, ez testua bakarrik: utzi osagaia erabiltzen duenari eduki aberatsa ematen, Reacten
childrenbidez, Vuen slot-en bidez edo Angularren eduki-proiekzioaren bidez, HTMLa kate batean sartzea bezalako trikimailuetara jo ez dezan.
Ohiko akatsa
Jasotako atributu guztiak kanpoko edukiontziaren gainean banatzen dituen eremu-osagai bat. Vuen lehenespenez gertatzen da: deklaratutako propietateak ez diren atributuak erro-elementuari aplikatzen zaizkio. Emaitza irakurgailuak alde batera uzten duen <div aria-describedby="ayuda-dni" aria-invalid="true"> bat da, eta deskribapenik eta errore-egoerarik gabeko <input> bat. Irtenbidea herentzia desaktibatzea eta atributuak kontrolera bideratzea da:
<script setup>
import { useId } from 'vue';
defineOptions({ inheritAttrs: false });
defineProps({ etiqueta: { type: String, required: true } });
const id = useId();
</script>
<template>
<div class="campo">
<label :for="id">{{ etiqueta }}</label>
<input :id="id" v-bind="$attrs">
</div>
</template>
Reacten, baliokidea gainerako propietateak (...resto) jasotzea eta <input>-aren gainean hedatzea da, ez bilgarriaren gainean.
Bilgarriak ez dezala semantika hautsi
HTMLko erlazio batzuek ahaidetasun zuzena eskatzen dute: <li> batek <ul> edo <ol> baten seme-alaba izan behar du, eta taula baten errenkadek eta gelaxkek beren tokian egon behar dute. Osagaiek erlazio horiek hausten dituzten tarteko elementuak sartzeko joera dute, eta irakurgailuak «zerrenda, 8 elementu» iragartzeari uzten dio, edo gelaxken eta goiburuen arteko lotura galtzen du.
- React: osagai batek hainbat elementu itzuli behar baditu, erabili zati bat (
<>…</>)divbaten ordez. - Vue 3: hainbat erro-nodo onartzen ditu; beraz, ez da bilgarri artifizialik behar.
- Angular: osagai bakoitza bere ostalari-elementuaren barruan errendatzen da (
<app-tramite>), eta hura<ul>-aren eta<li>-aren artean geratzen da. Irtenbidea atributu-hautatzaile bat da, ostalaria elementu semantikoa bera izan dadin:
@Component({
selector: 'li[appTramite]',
template: `<a [href]="url">{{ titulo }}</a>`,
})
export class TramiteComponent {
@Input() titulo = '';
@Input() url = '';
}
<!-- Erabilera: zerrendak zerrenda izaten jarraitzen du -->
<ul>
<li appTramite titulo="Erroldatzea" url="/padron"></li>
<li appTramite titulo="Aurretiazko hitzordua" url="/cita"></li>
</ul>
Kontuz display: contents-ekin, bilgarri bat «desagerrarazteko» lasterbide gisa: urte askoan, hainbat nabigatzailek elementuaren semantika ezabatzen zuten harekin (botoi bat edo taula bat izateari uzten zioten). Azken bertsioetan zuzendu bada ere, ez aplikatu funtzio propioa duten elementuei, eta egiaztatu irisgarritasun-zuhaitzean.
Web Components eta Shadow DOMa
Web Components (elementu pertsonalizatuak, <mi-interruptor> bezalakoak) frameworkik gabe osagai berrerabilgarriak sortzeko modu estandarra dira, eta diseinu-sistema askok erabiltzen dituzte teknologia desberdinak dituzten taldeei zerbitzua emateko. Ezagutu beharreko bi berezitasun dituzte.
Elementu pertsonalizatu batek ez du semantikarik
Nabigatzailearentzat, <mi-boton> elementu generiko bat da, span bat bezala: funtziorik, fokurik eta teklaturik gabe. Bi estrategia daude. Hobetsia elementu natibo bat biltzea da bere shadow root-aren barruan (osagaiaren barneko zuhaitz kapsulatua):
class MiBoton extends HTMLElement {
constructor() {
super();
const raiz = this.attachShadow({ mode: 'open', delegatesFocus: true });
raiz.innerHTML = '<button type="button"><slot></slot></button>';
}
}
customElements.define('mi-boton', MiBoton);
Barneko botoiak funtzioa, fokua eta teklatua ematen ditu, eta haren izena egileak <mi-boton>-en barruan jartzen duen testuarekin kalkulatzen da. delegatesFocus aukerari esker, ostalaria fokuratzean, fokua barruko lehen elementu fokugarrira pasatzen da.
Ostalariak kontrola bera izan behar duenean, ElementInternals interfazeak funtzioa eta egoerak lehenespenez emateko aukera ematen du, egileak nahi gabe zapal ditzakeen ARIA atributuak idatzi gabe:
class MiInterruptor extends HTMLElement {
#internals = this.attachInternals();
constructor() {
super();
this.#internals.role = 'switch';
this.#internals.ariaChecked = 'false';
this.addEventListener('click', () => this.alternar());
this.addEventListener('keydown', (e) => {
if (e.key === ' ') { e.preventDefault(); this.alternar(); }
});
}
connectedCallback() {
if (!this.hasAttribute('tabindex')) this.tabIndex = 0;
}
alternar() {
this.#internals.ariaChecked = String(this.#internals.ariaChecked !== 'true');
}
}
customElements.define('mi-interruptor', MiInterruptor);
Estrategia honekin, zuk hartzen duzu dena zure gain: fokua, teklatua, egoerak eta izena (egileak eman beharko duena aria-label edo aria-labelledby bidez). Web Componentsei aplikatutako ARIAren 1. araua da: elementu natibo bat badago, erabili barruan.
id bidezko erreferentziek ez dute Shadow DOMa zeharkatzen
Elementuak beren id-aren bidez erlazionatzen dituzten atributuek (for, aria-labelledby, aria-describedby, aria-controls, aria-activedescendant) zuhaitz beraren barruan bakarrik funtzionatzen dute. Dokumentuko etiketa batek ezin dio <input> bati seinalatu, hura shadow root baten barruan bizi bada, ezta barneko elementu batek kanpoko errore-mezu bati ere.
<!-- Okerra: benetako input-a campo-texto-ren shadow root-aren barruan dago -->
<label for="dni">NAN</label>
<campo-texto id="dni"></campo-texto> <!-- izen irisgarririk gabeko eremua -->
Irtenbideak, gomendagarrienetik gutxien gomendagarrira: etiketa, kontrola, laguntza eta errorea osagai beraren barruan mantentzea (testuak atributu edo propietate bidez jasotzen ditu); formularioari lotutako elementu bihurtzea (static formAssociated = true, ElementInternals-ekin batera), nabigatzaileak etiketagarritzat hartzen duena eta formularioaren bidalketan eta balioztatzean parte hartzen duena; edo, azken baliabide gisa, izena aria-label-ekin pasatzea. W3Cn eta nabigatzaileetan badaude muga hori zeharkatzen duten erreferentziak ahalbidetzeko proposamenak, baina haien euskarriak oraindik ez du haien mende egoteko aukerarik ematen.
Probatu zuk zeuk
Aukeratu zure diseinu-sistemako edo liburutegi ezagun bateko eremu-osagai bat. Ikuskatu <input>-a garapen-tresnetan eta ireki irisgarritasun-fitxa: egiaztatu haren izena, haren deskribapena eta invalid agertzen den eremuak errore bat duenean. Izena hutsik badago edo deskribapena iristen ez bada, begiratu zer elementuri aplikatzen ari zaizkion atributuak.
Osagai bakoitza dokumentatu eta probatu
Osagai irisgarri batek fitxa bat behar du, zer ebazten duen eta erabiltzen duenak zer eman behar duen esango duena: derrigorrezko propietateak (etiketa, elkarrizketa-koadroaren izenburua), teklatu-taula, osagaiak berak kudeatzen dituen ARIA atributuak eta erabilera zuzen eta okerren adibideak. Probatu egoera bakoitza (itxita, irekita, errorearekin, desgaituta) hurrengo ikasgaiko proba automatikoekin; axe-corek shadow root irekiak ere aztertzen ditu, eta Storybook bezalako osagai-katalogoen irisgarritasun-osagarriek arau horiek exekutatzen dituzte istorio bakoitzean. Saihestu mode: 'closed': barrualdea ezkutatzen die proba-tresnei, benetako segurtasunik eman gabe.
Funtsezko puntua
Osagai berrerabilgarri batek barruan duena biderkatzen du. Egin derrigorrezko izen irisgarria mende duen propietateak, bideratu atributuak benetako kontrolera, ez sartu zerrendak eta taulak hausten dituzten bilgarririk, eta, Web Componentsetan, bildu elementu natiboak eta mantendu etiketa eta kontrola elkarrekin zuhaitz beraren barruan.
Laburpena
- Diseinatu APIa izen irisgarria derrigorrezkoa izan dadin eta semantika erabileraren araberakoa izan dadin (esteka edo botoia, izenburu-maila konfiguragarria).
- Bideratu
id,aria-*eta gainerako atributuak benetako kontrolera (inheritAttrs: falseVuen, gainerako propietateak Reacten), eta erakutsi erreferentzia bat fokua kudeatzeko. - Saihestu bilgarriak
uletaliartean edo taulen barruan: zatiak Reacten, hainbat erro Vuen, atributu-hautatzaileak Angularren. - Elementu pertsonalizatu batek ez du semantikarik: bildu natibo bat, edo erabili
ElementInternals, fokua eta teklatua zure gain hartuta. idbidezko erreferentziek ez dute Shadow DOMa zeharkatzen: etiketa eta kontrola zuhaitz berean, edo formularioari lotutako elementua.
Ikastaro honetako 2 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.