Addaw, joan hasierara Egin dohaintza

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

Combobox, listbox eta osatze automatikoa

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

Garraio-webgune bateko geltoki-bilatzailea, egoitza elektronikoko eskaera bateko «Udalerria» eremua edo lineako denda bateko iradokizunak dituen bilatzailea osagai bera dira: idazten duzun bitartean aukera-zerrenda bat zabaltzen duen testu-eremu bat. APGk combobox deitzen dio, eta, alde handiz, gaizkien inplementatzen den patroia da. Formularioen ikastaroan ikusi zenuen noiz den nahikoa jatorrizko <select> bat; ikasgai honek ondoren datorrenaz dihardu: combobox editagarriaz, harekin batera doan aukera-zerrendaz (listbox) eta osatze automatikoari buruzko erabakiez. «Widget konposatuak» ikasgaiko aria-activedescendant teknika zuzenean aplikatzen du.

Eraiki aurretik: benetan behar duzu combobox bat?

BeharraGomendatutako irtenbidea
Aukera bat hautatzea gutxiren artean (5-7 arte)Jatorrizko aukera-botoiak <fieldset> baten barruan
Aukera bat hautatzea zerrenda ezagun eta ez oso luze batetikJatorrizko <select>, dagoeneko aurreidazketa duena
Ehunka balioren artean hautatzea (udalerriak, geltokiak, produktuak)Combobox editagarria, zerrenda iragaziarekin
Testu librea idaztea aukerako iradokizunekinCombobox-a, aria-autocomplete="list" atributuarekin
Beti ikusgai dagoen zerrenda batetik aukera bat edo batzuk hautatzealistbox (edo jatorrizko kontrol-laukiak, gutxi badira)

<datalist> elementuak iradokizunetarako jatorrizko irtenbidea dirudi, baina haren aurkezpena, testuaren tamaina eta pantaila-irakurgailuekin eta zoomarekin duen portaera nabigatzaileen arabera aldatzen dira, eta ia ez du estilorik onartzen. Prototipoetarako edo barne-tresnetarako balio du; zerbitzu publiko baterako edo merkataritza baterako, APG (leiho berri batean irekitzen da) patroiak kontrola eta emaitza aurreikusgarriak ematen dizkizu.

Combobox-aren anatomia WAI-ARIA 1.2ren arabera

ARIA 1.2n, combobox funtzioa testu-eremuan bertan jartzen da, ez hura biltzen duen edukiontzi batean, ARIA 1.1eko patroiak egiten zuen bezala. input elementua duen div role="combobox" bat duen kodea aurkitzen baduzu, eredu zaharra da. Egungo ereduak pieza hauek ditu:

<label for="origen">Jatorriko geltokia</label>
<input id="origen" type="text" role="combobox"
       aria-autocomplete="list" aria-expanded="true"
       aria-controls="origen-lista" aria-activedescendant="origen-op-2"
       autocomplete="off">
<ul id="origen-lista" role="listbox" aria-label="Geltokiak">
  <li id="origen-op-1" role="option" aria-selected="false">Madrid - Chamartín</li>
  <li id="origen-op-2" role="option" aria-selected="true">Madrid - Puerta de Atocha</li>
  <li id="origen-op-3" role="option" aria-selected="false">Málaga - María Zambrano</li>
</ul>
<div role="status" class="solo-lector">3 geltoki aurkitu dira</div>
  • role="combobox" input elementuan, <label> bidez lotutako etiketa ikusgai batekin.
  • aria-expanded atributuak islatzen du zerrenda zabalduta dagoen ala ez (true/false); eguneratu irekitzen edo ixten den bakoitzean.
  • aria-controls atributuak zerrenda gainerakorraren id-ra seinalatzen du. Zerrenda listbox bat izan ohi da, hori baita balio lehenetsia; beste zerbait bada (zuhaitz bat, sareta bat edo elkarrizketa-koadro bat), deklaratu aria-haspopup bidez.
  • aria-activedescendant atributuak aukera nabarmendura seinalatzen du, DOMaren fokua eremuan geratzen den bitartean, pertsonak idazten jarraitu ahal izan dezan. Nabarmendutakorik ez dagoenean, kendu atributua edo utzi hutsik.
  • Aukera bakoitzak role="option", id esklusibo bat eta, nabarmenduta dagoenean, aria-selected="true" ditu.
  • autocomplete="off" atributuak saihesten du nabigatzailearen iradokizunek zureak estaltzea. Erabili honelako eremuetan bakarrik; ez aplikatu datu pertsonalen eremuetan (izena, posta elektronikoa, helbidea), horiek beren autocomplete balioa behar baitute 1.3.5 Sarreraren helburua identifikatzea betetzeko.

Osatze automatikoaren lau motak

aria-autocomplete atributuak pantaila-irakurgailuari esaten dio zer gertatuko den idazten den bitartean:

  • none: zerrenda ez dago idatzitakoaren mende (adibidez, azken bost bilaketak erakusten ditu beti).
  • list: zerrenda idazten denarekin iragazten da. Kasurik ohikoena da eta ulertzen errazena.
  • inline: falta den testua eremuaren barruan bertan osatzen da, hautatuta, onartu edo gainidatz dadin.
  • both: zerrenda iragazia eta, gainera, lehen bat-etortzearen lerroko osatzea.

Lerroko osatzeak sakatzeak aurrezten ditu, baina nahasgarria izan daiteke desgaitasun kognitiboa duten pertsonentzat edo ahots bidez diktatzen duenarentzat, eremuak idatzi ez duen testua baitu. Erabiltzen baduzu, gehitutako testua argi eta garbi hautatuta ikusi behar da, eta Supr teklak edo idazten jarraitzeak baztertu egin behar du.

Inplementatu beharreko teklatua

TeklaPortaera
IdazteaZerrenda iragazten du eta zabaldu egiten du emaitzak badaude; ez du fokua eremutik mugitzen.
Behera geziaZerrenda irekitzen du itxita badago; irekita badago, hurrengo aukera nabarmentzen du.
Gora geziaAurreko aukera nabarmentzen du (aukeran, zerrenda irekitzen du eta azkena nabarmentzen du).
Alt+Behera geziaZerrenda irekitzen du aukerarik nabarmendu gabe.
SartuAukera nabarmendua onartzen du, haren testua eremuan idazten du eta zerrenda ixten du.
EscZerrenda ixten du; aukeran, dagoeneko itxita bazegoen, eremua husten du.
Ezkerreko eta eskuineko gezi-teklak, Hasiera, AmaieraKurtsorea testuaren barruan mugitzen dute, beste edozein eremutan bezala; ez dute zerrendan nabigatzen.
TabZerrenda ixten du eta hurrengo eremura pasatzen da; ez du isilean onartu behar pertsonak aukeratu ez duen aukerarik.

Saguarekin edo hatzarekin, aukera batean klik egiteak onartu egiten du. Xehetasun tekniko batek akats asko saihesten ditu: zerrenda eremuaren blur gertaeran ixten baduzu, aukeran egindako klika berandu iristen da, zerrenda dagoeneko desagertu delako. Deitu preventDefault() zerrendaren mousedown gertaeran, eremuak fokua gal ez dezan, edo atzeratu ixtea.

Ohiko akatsa

DOMaren fokua lehen iradokizunera eramatea zerrenda agertu bezain laster. Pertsona «Mad» idazten ari zen eta, bat-batean, haren sakatzeak aukera batera doaz eremura joan beharrean; pantaila-irakurgailua erabiltzen badu, gainera, ustekabeko iragarpen bat entzuten du hitzaren erdian. Fokua eremuan geratzen da, eta Behera gezia teklak bakarrik nabarmentzen ditu aukerak. Aldameneko akats bat: emaitzaren orrira nabigatzea aukera bat gezi-teklekin nabarmendu bezain laster, Sartu itxaron gabe; horrek ez du 3.2.2 Datuak sartzean betetzen.

Iragarri gainezka egin gabe

Pertsona itsu batek ez du ikusten zerrenda zabaldu dela ezta zenbat aukera dituen ere. aria-expanded atributuaz gain, role="status" eskualde batek (WAI-ARIA (leiho berri batean irekitzen da)ren ikastaroan ikusia) emaitza-kopuruaren berri ematen du: «12 geltoki aurkitu dira. Erabili gezi-teklak aukeratzeko». Hiru arau, lagundu dezan eta ez gogaitu:

  1. Atzeratu iragarpena ehunka milisegundo azken sakatzearen ondoren, letra bakoitzarekin zenbaketa desberdin bat ez irakurtzeko.
  2. Ez erabili role="alert" horretarako: irakurgailua esaten ari dena eteten du, idazten denaren oihartzuna barne.
  3. Iragarri hutsunea ere: «Ez dago "Madri" testuarekin bat datorren geltokirik». Agertzen ez den zerrenda batek ez du ezer jakinarazten berez.

Adibidea

Horrela entzun beharko litzateke NVDArekin ondo egindako geltoki-bilatzailea: fokuratzean, «Jatorriko geltokia, konbinazio-koadroa, tolestuta, editagarria». Pertsonak «mál» idazten du eta, eten baten ondoren, «2 geltoki aurkitu dira» entzuten du. Behera gezia sakatzen du: «Málaga - María Zambrano, 2tik 1.». Sartu: eremuak geltokia du, eta irakurgailuak «tolestuta» iragartzen du. Hitz zehatzak irakurgailuaren eta hizkuntzaren arabera aldatzen dira, baina elementuak beti berberak dira: izena, funtzioa, egoera, aukera eta posizioa.

Listbox independentea eta hautapen soileko combobox-a

listbox bat bakarrik ere joan daiteke, beti ikusgai: dokumentu bat itzultzeko hizkuntza-hautatzaile bat edo jakinarazpen baten hartzaileen zerrenda. Hainbat hautapen onartzen baditu, aria-multiselectable="true" du; aria-selected atributuak aukeratutako aukera bakoitza markatzen du, eta APGk gomendatzen duen eredua da Zuriune-barra teklak fokuratutako aukeraren hautapena txandakatzea, gezi-teklek mugitu baino egiten ez duten bitartean. Aukera gutxi badira, <fieldset> batean dauden jatorrizko kontrol-laukiak errazagoak dira, eta inork ez du teklatu berririk ikasi behar.

APGk, gainera, hautapen soileko combobox bat dokumentatzen du (select-only combobox): role="combobox" eta tabindex="0" dituen elementu ez-editagarri bat, <select> pertsonalizatu bat bezala jokatzen duena. Erabilgarria da diseinuak aukera bakoitzean <select> elementuak onartzen ez duen zerbait erakustea eskatzen duenean, ikono bat edo bigarren mailako testu bat adibidez; baina mantentzea askoz ere garestiagoa da. Galdetu zeure buruari lehenago ea estiloa emandako <select> bat ez den nahikoa.

Funtsezko puntua

ARIA 1.2ko combobox-a: funtzioa input elementuan, aria-expanded, aria-controls listbox elementura, aria-activedescendant aukera nabarmendura eta fokua beti eremuan. Ikusten ez dena egoera-eskualde batean iragartzen da, lasai eta emaitzarik ez dagoenean ere bai.

Nola egiaztatu

  • Idatzi, zeharkatu iradokizunak gezi-teklekin, onartu Sartu teklarekin, itxi Esc teklarekin eta irten Tab teklarekin: eremuak ez du inoiz fokua galdu behar ezta berez bete ere.
  • Pantaila-irakurgailuarekin, egiaztatu entzuten dituzula funtzioa, tolestuta edo zabalduta egoera, emaitzen zenbaketa eta aukera bakoitza bere posizioarekin.
  • Egiaztatu nabarmentzea: aukera aktiboa kolorea baino zerbait gehiagorekin eta gutxienez 3:1eko kontrastearekin bereizi behar da, eta ez du ikuspegitik kanpo geratu behar jaistean.
  • Handitu % 400era: zerrendak sartu egin behar du edo korritu, eremua estali gabe.
  • Ireki APGren Combobox patroia eta alderatu zure osagaia haren adibideekin, teklaz tekla.

Probatu zuk zeuk

Aukeratu maiz erabiltzen duzun webgune bateko iradokizunak dituen bilatzaile bat (denda bat, garraio-webgune bat edo zure intraneta bera). Ireki ikuskatzailea, hautatu eremua eta begiratu haren atributuak: ba al ditu role="combobox" atributua, aria-expanded atributua (idaztean aldatu behar da) eta aria-activedescendant atributua (Behera gezia sakatzean aldatu behar da)? Iradokizunak funtziorik gabeko <div> elementuak badira, badakizu zergatik ez dituen pantaila-irakurgailu batek iragartzen.

Laburpena

  • Combobox bat eraiki aurretik, baztertu aukera-botoiak eta jatorrizko <select> elementua; <datalist> ez da oso aurreikusgarria.
  • ARIA 1.2n combobox funtzioa eremuan doa, aria-expanded, aria-controls eta aria-activedescendant atributuekin; aukerak role="option" dira, aria-selected atributuarekin.
  • aria-autocomplete atributuak (none, list, inline, both) iragartzen du nola jokatzen duen eremuak idaztean.
  • Fokua ez da eremutik ateratzen; gezi-teklek nabarmentzen dute, Sartu teklak onartzen du, Esc teklak ixten du, eta nabarmentzea ez da nabigatzea (3.2.2).
  • Atzerapena duen role="status" eskualde batek emaitza-kopurua iragartzen du, zeroa barne.

Ikastaro honetako 3 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.