6. ikasgaia (10 guztira) · 13 min irakurtzeko · Berrikuspen-data: 26/10/2026
Teklatuko gertaerak eta laster-tekla propioak: ezer hautsi gabe inplementatu
Ikasgai ireki bat irakurtzen ari zara. Matrikulatu doan testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.
Lehen ikasgaian ikusi genuen zer eskatzen duen 2.1.4 Karaktere bakarreko laster-teklak irizpideak, eta aurrekoan gezi-teklentzako kudeatzaileak idatzi genituen. Aplikazio bat hazi bezain laster (espediente-kudeatzaile bat, editore bat, administrazio-panel bat), laster-tekla propioak agertzen dira: Ctrl+K bilatzeko, / bilatzailera joateko, ? laguntzarako. Ondo inplementatzeko, teklatuko gertaeren APIa, teklatu espainiarraren berezitasunak eta nabigatzaileak, sistemak eta pantaila-irakurgailuek dagoeneko hartuta dituzten konbinazioak ezagutu behar dira. Gaizki aukeratutako laster-tekla batek ez du laguntzen ez ezik, a bildua idaztea eragozten du edo NVDA erabiltzen duena funtziorik gabe uzten du.
keydown, key eta code
Sakatze bati erantzuteko gertaera keydown da. Sakatzean abiarazten da, eta tekla sakatuta mantentzen den bitartean errepikatzen da (e.repeat propietateak errepikapenak adierazten ditu). keyup gertaerak erabilera jakin batzuk ditu; keypress eta keyCode eta which propietateak zaharkituta daude, eta ez zenituzke kode berrian erabili behar.
Gertaera bakoitzak nahastu behar ez diren bi propietate dakartza:
e.key: teklaren balio logikoa, hau da, sortzen duen karakterea ("a","A","/") edo haren izena ("Enter","Escape","ArrowDown"). Teklatuaren banaketaren araberakoa da.e.code: teklaren posizio fisikoa ("KeyA","Digit7"), AEBko teklatutik hartutako izenekin, eta banaketatik independentea.
Arau praktikoa: letra edo ikurreko laster-teketarako, erabili key, pertsonak bere teklan inprimatuta ikusten duenarekin bat datorrelako. Gorde code posizioa garrantzitsua denerako, ezkerreko eskuaren norabide-teklak erabiltzen dituen joko batean bezala.
| Pertsonak sakatzen duena (teklatu espainiarra) | e.key | e.code |
|---|---|---|
| Sartu | "Enter" | "Enter" |
| Zuriune-barra | " " | "Space" |
| Maius+7 | "/" | "Digit7" |
| Azentuaren tekla, Ñ-ren eskuinean | "Dead" | "Quote" |
| AltGr+E Windowsen | "€", ctrlKey eta altKey true balioarekin | "KeyE" |
Adibidea
Bilatzailera joateko / laster-tekla bat, AEBko teklatua duen ordenagailu batean programatua, non barrak tekla propioa duen:
if (e.code === 'Slash') buscador.focus(); // okerraTeklatu espainiar batean, posizio hori hartzen duen teklak marratxoa sortzen du; beraz, laster-tekla «-» sakatzean abiaraziko litzateke, eta inoiz ez barrarekin, hemen Maius+7 sakatuta idazten baita. e.key === '/' erabilita, edozein banaketatan funtzionatzen du.
Aldatzaileak eta teklatu espainiarra
ctrlKey, altKey, shiftKey eta metaKey propietateek adierazten dute zer aldatzaile zeuden sakatuta. metaKey propietatea macOSeko Cmd teklari dagokio; han, konbentzioek Cmd erabiltzen dute Windowsek Ctrl erabiltzen duen lekuan; errazena biak onartzea da: (e.ctrlKey || e.metaKey) && e.key === 'k'.
Gure teklatuaren berezko bi tranpa:
- AltGr Ctrl+Alt-en baliokidea da Windowsen. Teklatu espainiar batean, a bildua, traola, euroa, kortxeteak, giltzak eta alderantzizko barra AltGr teklarekin idazten dira, eta Windowsek tekla hori Ctrl+Alt gisa jakinarazten du. Esportatzeko Ctrl+Alt+E definitzen baduzu, norbaitek «€» idazten duen bakoitzean dokumentua esportatuko du; Ctrl+Alt+2 erabilita, ezin izango du helbide elektroniko bat idatzi. Saihestu letrekin, zenbakiekin eta ikurrekin egindako Ctrl+Alt konbinazioak.
- Tekla hilak eta sarrera-metodoak. «á» idazteko, lehenik azentuaren tekla sakatzen da,
e.key === "Dead"gisa iristen dena, eta gero «a». Txinera edo japoniera bezalako hizkuntzetan, karaktereen konposizioake.isComposingbidez markatzen ditu gertaerak. Testu-eremu batekkeydownprozesatzen badu idazten dena eraikitzeko edo iragazteko, sarrera horiek hautsi egingo ditu. Idatzitakoari erantzuteko, entzuninputgertaera.
Hartutako konbinazioak
Ez dago ingurune guztietan libre dagoen laster-teklen eremurik. Aukeratu aurretik, berrikusi norekin egin dezakezun talka:
- Nabigatzailea. Konbinazio batzuk ezin dira orri batetik harrapatu (Chromen, adibidez, Ctrl+T, Ctrl+W edo Ctrl+N). Beste batzuk harrapa daitezke, hala nola Ctrl+F edo Ctrl+P, baina pertsonak haien ohiko portaera espero du: ordeztu soilik baliokidea den zerbait eskaintzen baduzu, nabigatzaileak egin ezin duen dokumentu luze baten barruko bilaketa bat kasu.
- Sistema eragilea. Alt+Tab, Windows teklarekin egindako konbinazioak edo Ctrl+Alt+Ezabatu ez dira inoiz orrira iristen. Windowsen, Alt+Maius teklek teklatuaren banaketa alda dezakete, hainbat instalatuta badaude.
- Pantaila-irakurgailuak. NVDAk Insert (eta aukeran Blok Maius) erabiltzen du tekla propio gisa; NVDAk eta JAWSek Ctrl+Alt+gezi-teklak erabiltzen dituzte taulak zeharkatzeko; macOSeko VoiceOverrek Ctrl+Option erabiltzen du aurrizki gisa. Gainera, arakatze moduan, irakurgailuek letra solteak atzematen dituzte, laguntza-teknologiei buruzko ikasgaian ikusiko duzunez.
Aukeratu laster-tekla gutxi, egiaztatu erabilienak diren nabigatzaile eta irakurgailuen konbinazio-zerrenden aurka, erakutsi interfazean eta utzi berriro esleitzen. Horrela, 2.1.4 betetzen duzu tekla bakarrekoak badira, eta gatazkak saihesten dituzu kasu guztietan.
Ondo inplementatutako tekla bakarreko laster-tekla bat
Gogora ditzagun 2.1.4ren baldintzak: tekla bakarreko laster-tekla batek desaktibatzeko edo berriro esleitzeko modukoa izan behar du, edo fokua duen osagaira mugatuta egon. Gainera, erabilgarritasun hutsagatik, ez da inoiz abiarazi behar pertsona idazten ari den bitartean. Kudeatzaile honek beharrezko egiaztapenak biltzen ditu:
const ajustes = cargarPreferencias(); // { atajosDeUnaTecla: true }, profilean gordeta
document.addEventListener('keydown', (e) => {
if (!ajustes.atajosDeUnaTecla) return; // 2.1.4: desaktiba daitezke
if (e.defaultPrevented || e.isComposing) return; // beste osagai batek kudeatu du dagoeneko
if (e.ctrlKey || e.metaKey || e.altKey) return; // ez da tekla bakarreko laster-tekla
const t = e.target;
if (t.isContentEditable || t.closest('input, textarea, select')) return; // idazten ari da
if (e.key === '/') {
e.preventDefault();
document.getElementById('buscar').focus();
} else if (e.key === '?') {
e.preventDefault();
abrirAyudaDeAtajos();
}
});
Ohartu shiftKey ez dela baztertzen: teklatu espainiarrean, / eta ? biek Maius behar dute. Eta preventDefault() laster-teklak erabiltzen dituen teklentzat soilik deitzen dela; beste edozein sakatzek bere bidea jarraitzen du.
Laster-teklak ezagutarazteko, konbinatu hiru gauza: interfazetik eskura dagoen laguntza bat («Laster-teklak» botoi bat, zerrenda eta desaktibatzeko aukera dituen elkarrizketa-koadro bat irekitzen duena), konbinazioa ikusgai ekintzaren ondoan (menuan, «Esportatu Ctrl+Maius+E») eta aria-keyshortcuts atributua, laster-tekla laguntza-teknologien eskura jartzen duena:
<button type="button" aria-keyshortcuts="Control+Shift+E">Esportatu</button>
aria-keyshortcuts atributuak informatu besterik ez du egiten: ez du laster-tekla inplementatzen, eta irakurgailu guztiek ez dute iragartzen. Ez du ordezten pantailan erakustea.
Ohiko akatsa
document.addEventListener('keydown', (e) => {
e.preventDefault(); // nabigatzaileak oztopa ez dezan
gestionarAtajo(e);
});Dokumentuan preventDefault() orokor batek baliogabetu egiten ditu Tab, eremuen barruko gezi-teklak, botoietako Zuriune-barra eta edozein formulariotako idazketa. Orri osoa teklatuarekin erabilezin bihurtzeko modu azkarra da (2.1.1). Bertan behera utzi kudeatu duzun tekla zehatza soilik.
Aldea egiten duten xehetasunak
- Sartu eta Zuriune-barra botoi propioetan. Botoi natibo batean, Sartu teklak klika abiarazten du sakatzean, eta Zuriune-barrak askatzean. Botoi bat berreraikitzen baduzu, xehetasun hori imitatzea fintasun bat da; ezinbestekoa da bi teklek funtzionatzea.
- Esc hierarkiarekin. Esc teklak irekitako azkena itxi behar du (elkarrizketa-koadroaren barruko goitibeherakoa elkarrizketa-koadroaren aurretik), ez dena batera. Gelditu hedapena hura kudeatzen duen osagaian.
- Sakatuta mantendutako teklak. Ekintza batek errepikatu behar ez badu (bidali, ezabatu), ez ikusi egin
e.repeatduten gertaerei. - Ez bikoiztu natiboa. Benetako
buttonbatek bere ekintzaclickgertaeran exekutatzen badu dagoeneko, ez gehitu hari ere deituko dion Sartu teklaren kudeatzaile bat: nabigatzaileak dagoeneko sortzen du klika tekla horrekin, eta ekintza bi aldiz exekutatuko da.
Probatu zuk zeuk
Edozein orritan, ireki garatzaileentzako tresnen kontsola (F12) eta itsatsi lerro hau:
addEventListener('keydown', (e) => console.log(e.key, e.code, e.ctrlKey, e.altKey, e.shiftKey));Sakatu Maius+7, azentuaren tekla eta, Windows erabiltzen baduzu, AltGr+E. Begiratu zer balio iristen diren, eta pentsatu zure aplikazioko zer laster-tekla abiaraziko liratekeen haiekin.
Funtsezko puntua
Erabili keydown eta e.key, saihestu Ctrl+Alt AltGr dela eta, ez abiarazi laster-teklarik pertsona idazten ari den bitartean, utzi bertan behera kudeatzen dituzun teklak soilik, eta eskaini beti laster-teklak ikusteko, desaktibatzeko eta berriro esleitzeko modu bat.
Laburpena
keydownda gertaera zuzena;keypress,keyCodeetawhichzaharkituta daude.e.keyteklak sortzen duena da, etae.codeharen posizio fisikoa; letra eta ikurreko laster-teketarako, erabilikey.- Windowsen, AltGr Ctrl+Alt gisa iristen da: konbinazio horiek talka egiten dute gaztelaniazko idazketarekin.
- Berrikusi nabigatzailearekin, sistemarekin eta pantaila-irakurgailuekin dauden gatazkak; erakutsi laster-teklak eta utzi desaktibatzen edo berriro esleitzen.
- Ez abiarazi inoiz laster-teklarik testu-eremu baten barruan, eta ez deitu
preventDefault()modu orokorrean.
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.