База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

KeyboardEvent: стойност на клавиша и автоматично повторение

Използвай `key`, за да разпознаеш стойността на клавиша, и `repeat`, за да различиш първото натискане от автоматичните повторения при задържане.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

event.key     // string, read-only
 event.repeat  // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })

KeyboardEvent.key е свойство само за четене със стойност от тип низ, например "Enter", "a" или "A". Стойността зависи от клавиатурната подредба и активните модификатори като Shift. За разлика от code, което обозначава физическата позиция на клавиша, key може да се промени между събитията, ако се промени състоянието на модификатор.

KeyboardEvent.repeat е булево свойство само за четене. При реални събития keydown стойността е false при първото натискане и true при следващите събития, породени от автоматично повторение. То не показва дали клавишът е натиснат в момента. Не всички клавиши се повтарят, а честотата на повторение зависи от средата.

За да изпълниш действие веднъж при всяко натискане на Enter, провери event.key === "Enter" && !event.repeat в обработчика на keydown. Ако действието трябва да се повтаря при задържане на клавиша, не филтрирай събитията по repeat.

KeyboardEvent е API на уеб платформата, а не част от ECMAScript 2024. Не приемай, че е налично във всяка среда за изпълнение на JavaScript; провери поддръжката в целевата среда.

Примери

{
  function handleKeydown(event) {
    if (event.key !== "Enter" || event.repeat) return;
    console.log("activate");
  }

  handleKeydown({ key: "Enter", repeat: false });
  handleKeydown({ key: "Enter", repeat: true });
  handleKeydown({ key: "Escape", repeat: false });
}

Резултат

activate

Изпълни кода в Node.js или в конзолата на браузъра. Вместо клавиатурни събития обработчикът получава директно три обикновени обекта със свойства `key` и `repeat`. Само за първия обект извежда `activate`; примерът проверява условието, а не честотата на повторение.

Свързани уроци

  • JavaScript · Урок 34 · Средно · Версия: 3
  • JavaScript · Урок 35 · Средно · Версия: 3
  • JavaScript · Урок 38 · Средно · Версия: 3

Източници