--- title: GlobalEventHandlers.onkeydown slug: Web/API/GlobalEventHandlers/onkeydown tags: - HTML DOM - Обробник подій - клавіатура - події клавіатури translation_of: Web/API/GlobalEventHandlers/onkeydown ---
{{ApiRef("HTML DOM")}}

Властивість onkeydown спільно з GlobalEventHandlers є EventHandler обробляє події {{event("keydown")}}.

Подія keydown спрацьовує, коли користувач натискає клавішу клавіатури.

Синтаксис

target.onkeydown = functionRef;

Значення

functionRef це ім'я функції або вираз функції. В якості єдиного аргументу функція отримує об'єкт {{domxref("KeyboardEvent")}}.

Приклад

У цьому прикладі виводитимуться значення {{domxref("KeyboardEvent.code")}} щоразу, коли ви натискаете клавішу всередині елемента  {{HtmlElement("input")}}.

HTML

<input>
<p id="log"></p>

JavaScript

const input = document.querySelector('input');
const log = document.getElementById('log');

input.onkeydown = logKey;

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

Підсумок

{{EmbedLiveSample("Example")}}

Специфікації

Specification Status Comment
{{SpecName('HTML WHATWG','webappapis.html#handler-onkeydown','onkeydown')}} {{Spec2('HTML WHATWG')}}

Сумісність з браузерами 

{{Compat("api.GlobalEventHandlers.onkeydown")}}

Нотатки щодо сумісності

Так якб Firefox 65 події клавіатури і ключа тепер запускаються під час складання IME, для поліпшення крос-браузерної сумісності для користувачів CJKT (bug 354358, також більш детальну інформацію дивіться keydown and keyup події наразі запускаються під час складання IME. Щоб проігнорувати всі події keyup , зробіть щось на зразок цього (229 це спеціальний набір значень для keyCode що відноситься до читу, який був використаний IME):

eventTarget.addEventListener("keydown", event => {
  if (event.isComposing || event.keyCode === 229) {
    return;
  }
  // зробити що-небудь    });

See also