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

CKTIS / JavaScript

KeyboardEvent: стойност на клавиша и състояние на съставяне на текст

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

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

Синтаксис

event.key // string, read-only
 event.isComposing // boolean, read-only

// event is a KeyboardEvent instance.
// To construct a synthetic event:
new KeyboardEvent("keydown", { key: "Enter", isComposing: true })

event.key и event.isComposing са свойства само за четене на екземпляр на KeyboardEvent. Те са част от уеб платформата, а не от ECMAScript 2024. Поддръжката им зависи от средата за изпълнение.

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

isComposing е булева стойност за конкретното събитие. При събитие, генерирано от браузъра, тя е true, ако то е настъпило след compositionstart и преди compositionend. Редакторът за метод на въвеждане (IME) може да използва Enter за потвърждаване на предложение за текст. Затова в обработчика на keydown не задействай клавишната комбинация, ако isComposing е true.

В началото или края на съставянето редът на събитията може да доведе до стойност false за isComposing, дори ако IME обработва клавиша. Тествай комбинациите от браузър и IME, които поддържаш. При нужда разгледай event.keyCode === 229 като остарял резервен вариант за съвместимост, а не като универсална гаранция.

Примери

{
  const shouldRunShortcut = (event) =>
    event.key === "Enter" && !event.isComposing;

  for (const options of [
    { key: "Enter", isComposing: true },
    { key: "Enter", isComposing: false },
    { key: "Escape", isComposing: false },
  ]) {
    // Without KeyboardEvent, test the predicate with a plain object.
    const event = typeof KeyboardEvent === "function"
      ? new KeyboardEvent("keydown", options)
      : options;
    console.log(shouldRunShortcut(event) ? "run" : "skip");
  }
}

Резултат

skip
run
skip

Изпълни примера с Node.js или в конзолата на поддържан браузър. Ако `KeyboardEvent` не е наличен, примерът използва обикновени обекти със същите тестови стойности. Само Enter извън съставянето извежда `run`. Примерът не изпраща събития и не активира истински IME.

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

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

Източници