Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Polja KeyboardEvent: značenje, položaj i stanje tipke

Razlikujte vrijednost tipke od njezina fizičkog položaja te provjerite ponavljanje, stanje tipke Shift i sastavljanje teksta. Ova polja KeyboardEvent pomažu pri obradi prečaca bez miješanja rasporeda tipkovnice s unesenim tekstom.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

event.key; event.code; event.repeat; event.shiftKey; event.isComposing

KeyboardEvent opisuje događaje tipkovnice kao što su keydown i keyup. Pet ovdje opisanih svojstava (key, code, repeat, shiftKey i isComposing) služi samo za čitanje, ali su neka svojstva naslijeđena iz sučelja Event, poput cancelBubble, dostupna i za pisanje. KeyboardEvent.key niz je koji označava značenje tipke uzimajući u obzir raspored i modifikatore, primjerice "z", "Z" ili "Enter". KeyboardEvent.code niz je koji neovisno o rasporedu identificira fizički položaj tipke: na tipkovnici QWERTZ uz key: "Z" može se pojaviti "KeyY". Za značenje tipke upotrijebite key, a za upravljanje koje ovisi o položaju code.

KeyboardEvent.repeat logička je vrijednost: true označava automatsko ponavljanje pritisnute tipke, a ne broj ponavljanja. U rukovatelju keydown izraz if (event.repeat) return; može preskočiti ponovljene radnje. KeyboardEvent.shiftKey označava je li Shift bio aktivan u trenutku događaja; to ne znači da se sam događaj odnosi na Shift. Pri pritisku tipke Shift (keydown) vrijednost je true; pri njezinu otpuštanju (keyup) može ostati true ako je druga tipka Shift još pritisnuta.

KeyboardEvent.isComposing logička je vrijednost koja označava događaj između compositionstart i compositionend, primjerice tijekom sastavljanja teksta putem IME-a. Preskakanje prečaca kada je vrijednost true smanjuje ometanje sastavljanja, ali ne prepoznaje sve rubne slučajeve IME-a: na početku ili kraju sastavljanja može biti false. Događaji tipkovnice ne zamjenjuju događaj input za praćenje promjena teksta.

To su web API-ji preglednika, a ne značajke određene edicije ECMAScripta; Node 24 u repozitoriju ne potvrđuje njihovu dostupnost. Provjerite kompatibilnost svakog svojstva u ciljnim preglednicima; MDN označava repeat kao Baseline 2025, što ne jamči podršku u starijim verzijama. Primjer stvara sintetički događaj s izričito zadanim vrijednostima: provjerava pristup poljima, a ne stvarne pritiske tipki ili ponašanje IME-a.

Primjeri

(() => {
  const event = new KeyboardEvent("keydown", {
    key: "Z",
    code: "KeyY",
    repeat: true,
    shiftKey: true,
    isComposing: false
  });

  const { key, code, repeat, shiftKey, isComposing } = event;
  console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();

Rezultat

{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori