GlobalEventHandlers.onkeydown
onkeydown
は GlobalEventHandlers
ミックスインのプロパティで keydown (en-US)
イベントを処理する event handler
です。
keydown
イベントは、ユーザーがキーボードのキーを押下した時に発生します。
構文
target.onkeydown = functionRef;
値
functionRef
は関数名または 関数式 です。この関数は、KeyboardEvent
オブジェクトとその 1 個の引数を受け取ります。
例
この例は、<input>
要素内でキーを押下するたびに、そのキーの KeyboardEvent.code
値をログ出力します。
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}`;
}
結果
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
HTML Living Standard onkeydown の定義 |
現行の標準 |
ブラウザーの互換性
BCD tables only load in the browser
互換性ノート
Firefox 65 以降、keyup (en-US)
および keydown (en-US)
イベントは、CJKT (中国、日本、韓国、台湾) ユーザーのブラウザー間の互換性を改善するために、IME 変換中に発生するようになりました (詳細は バグ 354358 および IME 変換中にも keydown、keyup イベントが発生するようになりました を参照)。変換対象の一部に対してすべての keydown
イベントを無視するには、次のようにしてください (229 は IME により処理されるイベントに関する keyCode
の特別な値セットです):
eventTarget.addEventListener("keydown", event => {
if (event.isComposing || event.keyCode === 229) {
return;
}
// do something
});
関連情報
keydown (en-US)
イベント- 関連するイベントハンドラー