UI Events KeyboardEvent key 値

W3C 勧告,

この文書についての詳細
このバージョン:
https://www.w3.org/TR/2025/REC-uievents-key-20250422/
最新公開バージョン:
https://www.w3.org/TR/uievents-key/
編集者草案:
https://w3c.github.io/uievents-key/
履歴:
https://www.w3.org/standards/history/uievents-key/
フィードバック:
GitHub
編集者:
(Google)
(招待専門家)
実装報告書:
https://w3c.github.io/uievents-key/impl-report.html
正誤表:
正誤表があります

翻訳も参照してください。


概要

この仕様は、KeyboardEventkey 属性に使用しなければならない key 属性値を定義する。この属性は、UI Events 仕様 [UIEvents] の一部として定義されている。

この文書のステータス

この節は、この文書の公開時点におけるステータスを説明する。現在の W3C 出版物の一覧と、この技術報告書の最新改訂版は、 https://www.w3.org/TR/ にある W3C 技術 報告書索引で確認できる。

この文書は、Web Applications Working Group により、 勧告トラックを使用する 勧告として公開された。

W3C は、この仕様を Web の 標準として広く展開することを推奨する。

W3C 勧告とは、広範な合意形成を経た後に、 W3C およびそのメンバーにより承認され、 実装に対して ロイヤリティフリー・ライセンス を提供するという作業グループメンバーからの確約を有する仕様である。

この文書は、 W3C 特許 ポリシーの下で運営される グループにより作成された。 W3C は、 そのグループの成果物に関連して行われた 特許開示の公開一覧 を維持している。そのページには、 特許を開示するための手順も含まれている。個人が、 その個人の実際の知識として、当該個人が 必須クレーム を含むと考える特許を知っている場合、その情報を W3C 特許ポリシー第 6 節に従って開示しなければならない。

この文書は、 2023年11月3日 W3C プロセス文書に準拠する。

1. はじめに

この文書は、キーの 意味を符号化するために KeyboardEventkey 属性で使用しなければならない、有効な key 属性値の集合を指定する。特定のキーに対する key 値は、ユーザーの現在のロケール設定に 基づいて異なることに注意すること。キーボード上のキーの物理的位置のみに 基づき、ロケールに基づいて変化しない値については、[UIEvents-Code] で説明される code を参照すること。

1.1. 表記上の規約

この仕様は、次の規約を使用する:

2. キーボードイベントの key 属性値

key 属性 値は、次のいずれかを 含む DOMString として定義される:

key 属性 値は、常にこれら 2 つのカテゴリのいずれかに該当する値を含まなければならない(値が "Unidentified" であっても)。

キーボード上の複数のキーが同じ key 属性値を生成することは許容される。たとえば、 EN-US キーボードレイアウトでは、 テンキー上のキー(たとえば、テンキーの 1 キー)は、 非テンキー側の対応するキー(たとえば、キーボードの主要部分にある 1 キー)と同じ key 属性 値を生成する。キーが テンキーに由来するかどうかを判定するために、KeyboardEventlocation 属性を使用できる。

2.1. Unicode 値

ほぼすべての Unicode 文字は、有効な key 属性値として使用できるが、 使用してはならない Unicode 文字の小さな集合が存在する。 キー 文字列の概念を導入し、 key 属性値として使用するのに適切な Unicode 文字列の集合を識別する。

キー文字列とは、 0 個または 1 個の 非制御文字(「基底」文字)に続いて、0 個以上の 結合 文字を含む文字列である。この文字列は、 [UAX15] で説明される Normalized Form C(NFC)で なければならない。

非制御 文字とは、 "Other, Control"("Cc")一般カテゴリに属するものを除く、任意の有効な Unicode 文字である。

結合 文字とは、 "Mark, Spacing Combining"("Mc")一般カテゴリに属する、またはゼロでない Combining Class を持つ、任意の有効な Unicode 文字である。

次は単純な キー文字列の例である:
Tab および Enter§ 2.1.1 制御文字を参照)を除き、 すべての非制御空白 Unicode 文字は、 有効な キー文字列と見なされる。
次は、キー文字列結合 文字を伴う例である:

2.1.1. 制御文字

Unicode "Cc" 一般カテゴリに属する少数の文字は、 名前付き key 属性値としてサポートされる。これらの名前付き値は 次のとおりである:

2.2. key 属性値の選択

グリフ修飾キーとは、 次の修飾キーのいずれかである: Shift, CapsLock または AltGr

2.2.1. 適切な key 属性 値を選択する

KeyboardEventkey 属性に格納するために 適切な key 属性値を選択するには、次の手順を実行する:
  1. key を、初期値として "Unidentified" に設定された DOMString とする。

  2. このキーイベントに対する適切な 名前付き key 属性値が 存在する場合、

    1. key をその 名前付き key 属性値に設定する。

  3. そうでなく、このキーイベントが有効な キー文字列を生成する場合、

    1. key をその キー文字列値に設定する。

  4. そうでなく、このキーイベントが グリフ修飾キー以外の修飾キーを持つ場合、

    1. key を、このイベントが グリフ修飾キーを除くすべての修飾キーを外した状態で 入力されたなら生成されたであろう キー文字列に設定する。

  5. このキーイベントの key 属性値として key を返す。

標準的な US キーボードでは、Q とラベル付けされたキーの key 属性値"q" である(Shift 修飾 キーも押されている場合は "Q")。

標準的な US キーボードでは、Control + Q に対する key 属性値"q" である。

右手用 Dvorak キーマッピングを持つ US キーボードでは、 Q とラベル付けされたキーの key 属性値"5" である("%"Shift 修飾付き)。

前の例と同じ US Dvorak キーボードレイアウトでは、Control + Q に対する key 属性値"5" である。

Bolnagri キーボードレイアウトでは、 Q とラベル付けされたキーに対する key 属性値は、単一の Unicode 文字 U+200C(ZWNJ または Zero Width Non-Joining Space)を含む文字列である。

標準フランス語マッピングを持つフランス語 PC キーボードでは、^ キーは結合サーカムフレックス・ダイアクリティカルマークの デッド キーとして動作する。 このキーボードイベントの key 属性 値"Dead" である。

同じく標準フランス語マッピングを持つフランス語 キーボードでは、é キー (US キーボード上の 2 キーに対応する)の key 属性値"é"U+00E9)である。

標準韓国語マッピングを持つ韓国語 PC キーボードでは、Ha/En キーの主な 機能はハングル入力と英語入力を切り替えることである。このキーには 名前付き key 属性値として "HangulMode" の項目があるため、それを key 属性 値として使用すべきである。

3. 名前付き key 属性値

名前付き key 属性値とは、この節のいずれかの表の key 属性値列に示される値の いずれかである。

ここで定義される 名前付き key 属性値は、 Java Platform, Standard Edition 6 API Specification [KeyEventJava]java.awt.event.KeyEvent インターフェイスのキーコード集合、および Microsoft .NET Framework 4.0 Class Library [KeysNet]System.Windows.Forms.Keys キー列挙に一部基づいている。この 仕様の追加情報は、Microsoft の WM_APPCOMMAND メッセージ [WmAppCommand]、およびこの文書に記される 他のより専門的な仕様に由来する。

KeyboardEvent インターフェイスの適合実装は、 key 属性で使用するために この値集合をサポートしなければならない。 ただし、すべての値がすべてのプラットフォームまたはデバイスで利用可能とは限らない。

この仕様の将来のバージョンでは、ここに含まれていないが、 この仕様の公開以降に一般的になった key 値が含まれる可能性がある。

注: この値一覧を可能な限り完全にするためにあらゆる試みがなされているが、 新しい入力デバイスが導入されるにつれて、新しい値を定期的に定義する必要がある。 ユーザーエージェントが独自の 名前付き key 属性値 を定義できるようにするのではなく(複数のユーザーエージェント間で一貫する可能性が低いため)、 この仕様を更新できるようにバグを提出すべきである。

3.1. 特殊キー

キーを識別できない実装は、key 属性値として "Unidentified" を使用しなければならない。

key 属性値 必須 典型的な用途(非規範)
"Unidentified" はい このキー値は、ハードウェア、 プラットフォーム、またはソフトウェアの制約により、実装が他のキー値を識別できない場合に使用される。

適合実装は、実装がキー値を検出する方法がない場合にのみ、 キー値として "Unidentified" を使用しなければならない。 すべてのキーボードイベントに対してこの値のみを公開することは、 適合実装を示すものであってはならない。

3.2. 修飾キー

key 属性値 必須 典型的な用途(非規範)
"Alt" はい Alt(Alternative)キー。
このキーは、同時または後続のキーボード入力を解釈するための代替 修飾機能を有効にする。
このキー値は、Apple の Option キーにも使用される。
"AltGraph" はい Alternate Graphics(AltGr または AltGraph)キー。このキーは ISO Level 3 shift 修飾キーを有効にするために使用される (標準の Shift キーは level 2 修飾キーである)。 [ISO9995-1] を参照。
"CapsLock" はい Caps Lock(Capital)キー。後続のキーボード入力イベントを解釈するために、 大文字ロック機能を切り替える。
"Control" はい Control または Ctrl キー。同時または後続のキーボード入力を解釈するための control 修飾機能を有効にする。
"Fn" いいえ Function 切り替え Fn キー。
このキーを別のキーと同時に有効化すると、 そのキーの値が代替文字または機能に変更される。 このキーは多くの場合キーボードハードウェアで直接処理され、通常はキーイベントを生成しない。
"FnLock" いいえ Function-Lock(FnLock または F-Lock) キー。このキーを有効化すると、一部のキーの値を 代替文字または機能に変更するようにキーボードのモードを切り替える。 このキーは多くの場合キーボードハードウェアで直接処理され、通常はキーイベントを生成しない。
"Meta" はい Meta キー。同時または後続のキーボード入力を解釈するための meta 修飾機能を有効にする。このキー値は、Windows Logo キーおよび Apple の Command または キーに使用される。
"NumLock" はい NumLock または Number Lock キー。後続のキーボード入力を解釈するための テンキーモード機能を切り替える。
"ScrollLock" はい Scroll Lock キー。スクロールとカーソル移動 モードを切り替える。
"Shift" はい Shift キー。同時または後続のキーボード入力を解釈するための shift 修飾機能を有効にする。
"Symbol" いいえ Symbol 修飾キー(一部の仮想キーボードで使用される)。
"SymbolLock" いいえ Symbol Lock キー。

旧来の修飾キー:

key 属性値 必須 典型的な用途(非規範)
"Hyper" いいえ Hyper キー。
"Super" いいえ Super キー。

3.3. 空白キー

key 属性値 必須 典型的な用途(非規範)
"Enter" はい Enter または キー。現在の 選択を有効化する、または現在の入力を受け入れる。
このキー値は Return(Macintosh テンキー)キーにも使用される。
このキー値は Android KEYCODE_DPAD_CENTER にも使用される。
"Tab" はい 水平タブ Tab キー。

Space または Spacebar キーは " " として符号化される。

3.4. ナビゲーションキー

key 属性値 必須 典型的な用途(非規範)
"ArrowDown" はい 下矢印キー。下方向にナビゲートまたは移動するため。(KEYCODE_DPAD_DOWN)
"ArrowLeft" はい 左矢印キー。左方向にナビゲートまたは移動するため。(KEYCODE_DPAD_LEFT)
"ArrowRight" はい 右矢印キー。右方向にナビゲートまたは移動するため。(KEYCODE_DPAD_RIGHT)
"ArrowUp" はい 上矢印キー。上方向にナビゲートまたは移動するため。(KEYCODE_DPAD_UP)
"End" はい End キー。キーボード入力とともに使用され、内容の末尾へ移動するため。(KEYCODE_MOVE_END)。
"Home" はい Home キー。キーボード入力とともに使用され、内容の先頭へ移動するため。(KEYCODE_MOVE_HOME)。
携帯電話の Home キー(電話のメイン画面へ移動する)については、"GoHome" を使用する。
"PageDown" はい Page Down キー。下へスクロールする、または内容の次ページを表示するため。
"PageUp" はい Page Up キー。上へスクロールする、または内容の前ページを表示するため。

3.5. 編集キー

key 属性値 必須 典型的な用途(非規範)
"Backspace" はい Backspace キー。このキー値は MacOS キーボードで Delete とラベル付けされたキーにも使用される。
"Clear" いいえ 現在選択されている入力を削除する。
"Copy" いいえ 現在の選択範囲をコピーする。(APPCOMMAND_COPY)
"CrSel" いいえ Cursor Select(Crsel)キー。
"Cut" いいえ 現在の選択範囲を切り取る。(APPCOMMAND_CUT)
"Delete" はい Delete(Del)キー。このキー値は MacOS キーボードで Delete とラベル付けされたキーが Fn キーで修飾された場合にも使用される。
"EraseEof" いいえ Erase to End of Field キー。このキーは、現在のカーソル位置から現在のフィールドの末尾までの すべての文字を削除する。
"ExSel" いいえ Extend Selection(Exsel)キー。
"Insert" はい Insert(Ins)キー。挿入または上書きのテキストモードを切り替えるため。(KEYCODE_INSERT)
"Paste" いいえ Paste キー。(APPCOMMAND_PASTE)
"Redo" いいえ 最後の操作をやり直す。(APPCOMMAND_REDO)
"Undo" いいえ 最後の操作を元に戻す。(APPCOMMAND_UNDO)

3.6. UI キー

key 属性値 必須 典型的な用途(非規範)
"Accept" いいえ Accept(Commit, OK)キー。現在の選択肢または入力メソッドシーケンス変換を受け入れる。
"Again" いいえ Again キー。操作をやり直す、または繰り返すため。
"Attn" いいえ Attention(Attn)キー。
"Cancel" いいえ Cancel キー。
"ContextMenu" はい アプリケーションのコンテキストメニューを表示する。このキーは通常、右 Meta キーと右 Control キーの間にある。
"Escape" はい Esc キー。このキーは元々エスケープ シーケンスを開始するために使用されたが、現在ではダイアログを閉じる または全画面モードを終了するなど、現在のコンテキストから出る、または "escape" するためにより一般的に使用される。
"Execute" いいえ Execute キー。
"Find" いいえ Find ダイアログを開く。(APPCOMMAND_FIND)
"Help" はい ヘルプダイアログを開く、またはヘルプ情報の表示を切り替える。(APPCOMMAND_HELP, KEYCODE_HELP)
"Pause" はい 現在の状態またはアプリケーションを(適切であれば)一時停止する。

メディアコントローラーの Pause ボタンにはこの値を使用しないこと。代わりに "MediaPause" を使用すること。

"Play" いいえ 現在の状態またはアプリケーションを(適切であれば)再生または再開する。

メディアコントローラーの Play ボタンにはこの値を使用しないこと。代わりに "MediaPlay" を使用すること。

"Props" いいえ Properties(Props)キー。
"Select" いいえ Select キー。
"ZoomIn" いいえ ZoomIn キー。(KEYCODE_ZOOM_IN)
"ZoomOut" いいえ ZoomOut キー。(KEYCODE_ZOOM_OUT)

3.7. デバイスキー

key 属性値 必須 典型的な用途(非規範)
"BrightnessDown" いいえ Brightness Down キー。通常、ディスプレイの明るさを制御する。(KEYCODE_BRIGHTNESS_DOWN)
"BrightnessUp" いいえ Brightness Up キー。通常、ディスプレイの明るさを制御する。(KEYCODE_BRIGHTNESS_UP)
"Eject" いいえ リムーバブルメディアの状態を、取り出し(開く)と挿入(閉じる)との間で切り替える。(KEYCODE_MEDIA_EJECT)
"LogOff" いいえ LogOff キー。
"Power" いいえ 電源状態を切り替える。(KEYCODE_POWER)

注: 一部のデバイスは、このキーをオペレーティング 環境に公開しない場合がある。

"PowerOff" いいえ PowerOff キー。PowerDown と呼ばれることもある。
"PrintScreen" はい Print Screen または SnapShot キー。 print-screen 機能を開始するため。
"Hibernate" いいえ Hibernate キー。このキーは、コンピューターの現在の状態をディスクに保存し、後で復元できるようにする。 その後、コンピューターはシャットダウンする。
"Standby" いいえ Standby キー。このキーは、完全にシャットダウンせずにディスプレイをオフにし、 コンピューターを低電力モードにする。 Suspend または Sleep キーとラベル付けされることもある。(KEYCODE_SLEEP)
"WakeUp" いいえ WakeUp キー。(KEYCODE_WAKEUP)

3.8. IME および合成キー

key 属性値 必須 典型的な用途(非規範)
"AllCandidates" いいえ All Candidates キー。複数候補モードを開始するため。
"Alphanumeric" いいえ Alphanumeric キー。
"CodeInput" いいえ Code Input キー。文字をその符号位置により入力できるようにする Code Input モードを開始するため。
"Compose" いいえ Compose キー。X Window System では Multi_key としても知られる。このキーは、 後続のキー押下を組み合わせて異なる文字を生成するモードをトリガーし、 デッドキーに似た方法で動作する。
"Convert" いいえ Convert キー。現在の入力メソッドシーケンスを変換するため。
"Dead" いいえ デッドキー結合キー。任意のキーボードレイアウトに由来する任意の結合キーであり得る。たとえば、 フランス語マッピングを使用し、修飾キーが有効化されていない PC/AT フランス語キーボードでは、これは キー値 U+0302 COMBINING CIRCUMFLEX ACCENT である。別のレイアウトでは、 異なる Unicode 結合キーである可能性がある。
特定の結合文字を区別する必要があるアプリケーションでは、 関連する compositionupdate イベントの data 属性が、 具体的なキー値を提供する。
"FinalMode" いいえ 一部のアジア系キーボードで使用される Final Mode Final キー。 IME の final mode を有効にするため。
"GroupFirst" いいえ 最初の文字グループに切り替える。(ISO/IEC 9995)
"GroupLast" いいえ 最後の文字グループに切り替える。(ISO/IEC 9995)
"GroupNext" いいえ 次の文字グループに切り替える。(ISO/IEC 9995)
"GroupPrevious" いいえ 前の文字グループに切り替える。(ISO/IEC 9995)
"ModeChange" いいえ Mode Change キー。IME の入力モードを切り替える、または循環させるため。
"NextCandidate" いいえ Next Candidate ファンクションキー。
"NonConvert" いいえ NonConvert("Don’t Convert")キー。IME において、現在の入力メソッドシーケンスを変換せずに 受け入れるため。
"PreviousCandidate" いいえ Previous Candidate ファンクションキー。
"Process" いいえ Process キー。
"SingleCandidate" いいえ Single Candidate ファンクションキー。

韓国語キーボード固有のキー:

key 属性値 必須 典型的な用途(非規範)
"HangulMode" いいえ Hangul(韓国語文字)Mode キー。ハングルモードと英語モードを切り替えるため。
"HanjaMode" いいえ Hanja(韓国語文字)Mode キー。
"JunjaMode" いいえ Junja(韓国語文字)Mode キー。

日本語キーボード固有のキー:

key 属性値 必須 典型的な用途(非規範)
"Eisu" いいえ Eisu キー。このキーは IME を閉じる場合があるが、その目的は現在の IME により定義される。(KEYCODE_EISU)
"Hankaku" いいえ (半角)文字キー。
"Hiragana" いいえ Hiragana(日本語かな文字)キー。
"HiraganaKatakana" いいえ Hiragana/Katakana 切り替えキー。(KEYCODE_KATAKANA_HIRAGANA)
"KanaMode" いいえ Kana Mode(Kana Lock)キー。このキーは、(通常はローマ字モードから)ひらがなモードに入るために使用される。
"KanjiMode" いいえ Kanji(中国起源の表意文字に対する日本語名)Mode キー。このキーは通常、入力を漢字に変換する目的で ひらがなキーボードへ切り替えるために使用される。(KEYCODE_KANA)
"Katakana" いいえ Katakana(日本語かな文字)キー。
"Romaji" いいえ ローマ字ファンクションキー。
"Zenkaku" いいえ Zenkaku(全角)文字キー。
"ZenkakuHankaku" いいえ Zenkaku/Hankaku(全角/半角)切り替えキー。(KEYCODE_ZENKAKU_HANKAKU)

3.9. 汎用ファンクションキー

これらの汎用ファンクションキーの正確な数はプラットフォームごとに異なり、 ここでは最初のいくつかのみを明示的に定義する。追加の ファンクションキー名は、ファンクションキー名の末尾にある 10 進数のインデックスを増分することにより 暗黙的に定義される。したがって、"F24" および "Soft8" はすべて有効なキー値である。

key 属性値 必須 典型的な用途(非規範)
"F1" はい F1 キー。インデックス 1 の汎用ファンクションキー。
"F2" はい F2 キー。インデックス 2 の汎用ファンクションキー。
"F3" はい F3 キー。インデックス 3 の汎用ファンクションキー。
"F4" はい F4 キー。インデックス 4 の汎用ファンクションキー。
"F5" はい F5 キー。インデックス 5 の汎用ファンクションキー。
"F6" はい F6 キー。インデックス 6 の汎用ファンクションキー。
"F7" はい F7 キー。インデックス 7 の汎用ファンクションキー。
"F8" はい F8 キー。インデックス 8 の汎用ファンクションキー。
"F9" はい F9 キー。インデックス 9 の汎用ファンクションキー。
"F10" はい F10 キー。インデックス 10 の汎用ファンクションキー。
"F11" はい F11 キー。インデックス 11 の汎用ファンクションキー。
"F12" はい F12 キー。インデックス 12 の汎用ファンクションキー。
"Soft1" いいえ 汎用仮想ファンクションキー。インデックス 1。
"Soft2" いいえ 汎用仮想ファンクションキー。インデックス 2。
"Soft3" いいえ 汎用仮想ファンクションキー。インデックス 3。
"Soft4" いいえ 汎用仮想ファンクションキー。インデックス 4。

3.10. マルチメディアキー

これらは「マルチメディア」キーボードに見られる追加キーである。

key 属性値 必須 典型的な用途(非規範)
"ChannelDown" いいえ 次の(数値的または論理的に)低いチャンネルを選択する。(APPCOMMAND_MEDIA_CHANNEL_DOWN, KEYCODE_CHANNEL_DOWN)
"ChannelUp" いいえ 次の(数値的または論理的に)高いチャンネルを選択する。(APPCOMMAND_MEDIA_CHANNEL_UP, KEYCODE_CHANNEL_UP)
"Close" いいえ 現在の文書またはメッセージを閉じる(注: これはアプリケーションを閉じるものではない)。(APPCOMMAND_CLOSE)
"MailForward" いいえ 現在のメッセージを転送するためのエディターを開く。(APPCOMMAND_FORWARD_MAIL)
"MailReply" いいえ 現在のメッセージに返信するためのエディターを開く。(APPCOMMAND_REPLY_TO_MAIL)
"MailSend" いいえ 現在のメッセージを送信する。(APPCOMMAND_SEND_MAIL)
"MediaClose" いいえ 現在のメディアを閉じる。たとえば CD または DVD トレイを閉じるため。(KEYCODE_MEDIA_CLOSE)
"MediaFastForward" いいえ 通常より速い速度での前方再生を開始または継続する、またはすでに早送り中であれば 速度を上げる。(APPCOMMAND_MEDIA_FAST_FORWARD, KEYCODE_MEDIA_FAST_FORWARD)
"MediaPause" いいえ 現在再生中のメディアを一時停止する。(APPCOMMAND_MEDIA_PAUSE, KEYCODE_MEDIA_PAUSE)

メディアコントローラーデバイスは、その一時停止キーに対して "Pause" ではなく、この値を使用すべきである。

"MediaPlay" いいえ 現在通常速度で再生されていない場合、通常速度でのメディア再生を開始または継続する。 (APPCOMMAND_MEDIA_PLAY, KEYCODE_MEDIA_PLAY)
"MediaPlayPause" いいえ メディアを再生状態と一時停止状態の間で切り替える。(APPCOMMAND_MEDIA_PLAY_PAUSE, KEYCODE_MEDIA_PLAY_PAUSE)
"MediaRecord" いいえ 現在選択されているメディアの録画を開始または再開する。(APPCOMMAND_MEDIA_RECORD, KEYCODE_MEDIA_RECORD)
"MediaRewind" いいえ 通常より速い速度での逆再生を開始または継続する、またはすでに巻き戻し中であれば 速度を上げる。(APPCOMMAND_MEDIA_REWIND, KEYCODE_MEDIA_REWIND)
"MediaStop" いいえ まだ停止していない場合、メディアの再生、一時停止、早送り、巻き戻し、または録画を停止する。(APPCOMMAND_MEDIA_STOP, KEYCODE_MEDIA_STOP)
"MediaTrackNext" いいえ 次のメディアまたは番組トラックへシークする。(APPCOMMAND_MEDIA_NEXTTRACK, KEYCODE_MEDIA_NEXT)
"MediaTrackPrevious" いいえ 前のメディアまたは番組トラックへシークする。(APPCOMMAND_MEDIA_PREVIOUSTRACK, KEYCODE_MEDIA_PREVIOUS)
"New" いいえ 新しい文書またはメッセージを開く。(APPCOMMAND_NEW)
"Open" いいえ 既存の文書またはメッセージを開く。(APPCOMMAND_OPEN)
"Print" いいえ 現在の文書またはメッセージを印刷する。(APPCOMMAND_PRINT)
"Save" いいえ 現在の文書またはメッセージを保存する。(APPCOMMAND_SAVE)
"SpellCheck" いいえ 現在の文書または選択範囲のスペルチェックを行う。(APPCOMMAND_SPELL_CHECK)

3.11. マルチメディアテンキー

通常の 0 ... 9 テンキーは "0" ... "9" として符号化されるが、一部の マルチメディアキーパッドには 1 ... 12 の番号が付いたボタンがある。 これらの場合、10 キーはしばしば 10 /0 とラベル付けされる。

注: サポートされる場合、10 または 10 /0 キーには、key"0" を割り当てなければならない。

key 属性値 必須 典型的な用途(非規範)
"Key11" いいえ 1 ... 12 のボタンを持つメディアテンキーに見られる 11 キー。
"Key12" いいえ 1 ... 12 のボタンを持つメディアテンキーに見られる 12 キー。

3.12. オーディオキー

オーディオに関連するマルチメディアキー。

key 属性値 必須 典型的な用途(非規範)
"AudioBalanceLeft" いいえ オーディオバランスを左方向に調整する。(VK_AUDIO_BALANCE_LEFT)
"AudioBalanceRight" いいえ オーディオバランスを右方向に調整する。(VK_AUDIO_BALANCE_RIGHT)
"AudioBassBoostDown" いいえ オーディオの bass boost を下げる、または bass boost 状態を下方向に循環させる。(APPCOMMAND_BASS_DOWN, VK_BASS_BOOST_DOWN)
"AudioBassBoostToggle" いいえ bass boost のオン/オフを切り替える。(APPCOMMAND_BASS_BOOST)
"AudioBassBoostUp" いいえ オーディオの bass boost を上げる、または bass boost 状態を上方向に循環させる。(APPCOMMAND_BASS_UP, VK_BASS_BOOST_UP)
"AudioFaderFront" いいえ オーディオフェーダーを前方へ調整する。(VK_FADER_FRONT)
"AudioFaderRear" いいえ オーディオフェーダーを後方へ調整する。(VK_FADER_REAR)
"AudioSurroundModeNext" いいえ サラウンドオーディオモードを次に利用可能なモードへ進める。(VK_SURROUND_MODE_NEXT)
"AudioTrebleDown" いいえ treble を下げる。(APPCOMMAND_TREBLE_DOWN)
"AudioTrebleUp" いいえ treble を上げる。(APPCOMMAND_TREBLE_UP)
"AudioVolumeDown" いいえ オーディオ音量を下げる。(APPCOMMAND_VOLUME_DOWN, KEYCODE_VOLUME_DOWN)
"AudioVolumeUp" いいえ オーディオ音量を上げる。(APPCOMMAND_VOLUME_UP, KEYCODE_VOLUME_UP)
"AudioVolumeMute" いいえ ミュート状態と前の音量レベルとの間で切り替える。(APPCOMMAND_VOLUME_MUTE, KEYCODE_VOLUME_MUTE)
"MicrophoneToggle" いいえ マイクのオン/オフを切り替える。(APPCOMMAND_MIC_ON_OFF_TOGGLE)
"MicrophoneVolumeDown" いいえ マイク音量を下げる。(APPCOMMAND_MICROPHONE_VOLUME_DOWN)
"MicrophoneVolumeUp" いいえ マイク音量を上げる。(APPCOMMAND_MICROPHONE_VOLUME_UP)
"MicrophoneVolumeMute" いいえ マイクをミュートする。(APPCOMMAND_MICROPHONE_VOLUME_MUTE, KEYCODE_MUTE)

3.13. 音声キー

音声認識に関連するマルチメディアキー。

key 属性値 必須 典型的な用途(非規範)
"SpeechCorrectionList" いいえ 単語が誤って識別された場合に修正リストを表示する。(APPCOMMAND_CORRECTION_LIST)
"SpeechInputToggle" いいえ ディクテーションモードとコマンド/制御モードの間で切り替える。(APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE)

3.14. アプリケーションキー

Application Keys は、特定のアプリケーションを起動するために割り当てられる特殊キーである。 追加のアプリケーションキー名は、"Launch" とアプリケーション名を連結することにより定義できる。

key 属性値 必須 典型的な用途(非規範)
"LaunchApplication1" いいえ 最初の汎用 "LaunchApplication" キー。これは一般に "My Computer" の起動に関連付けられ、キー上にコンピューター記号がある場合がある。(APPCOMMAND_LAUNCH_APP1)
"LaunchApplication2" いいえ 2 番目の汎用 "LaunchApplication" キー。これは一般に "Calculator" の起動に関連付けられ、キー上に電卓記号がある場合がある。(APPCOMMAND_LAUNCH_APP2, KEYCODE_CALCULATOR)
"LaunchCalendar" いいえ "Calendar" キー。(KEYCODE_CALENDAR)
"LaunchContacts" いいえ "Contacts" キー。(KEYCODE_CONTACTS)
"LaunchMail" いいえ "Mail" キー。(APPCOMMAND_LAUNCH_MAIL)
"LaunchMediaPlayer" いいえ "Media Player" キー。(APPCOMMAND_LAUNCH_MEDIA_SELECT)
"LaunchMusicPlayer" いいえ "Music Player" キー。
"LaunchPhone" いいえ "Phone" キー。
"LaunchScreenSaver" いいえ "Screen Saver" キー。
"LaunchSpreadsheet" いいえ "Spreadsheet" キー。
"LaunchWebBrowser" いいえ "Web Browser" キー。
"LaunchWebCam" いいえ "WebCam" キー。
"LaunchWordProcessor" いいえ "Word Processor" キー。

3.15. ブラウザーキー

key 属性値 必須 典型的な用途(非規範)
"BrowserBack" いいえ 現在の履歴内の前の内容またはページへ移動する。(APPCOMMAND_BROWSER_BACKWARD)
"BrowserFavorites" いいえ ブラウザーのお気に入り一覧を開く。(APPCOMMAND_BROWSER_FAVORITES)
"BrowserForward" いいえ 現在の履歴内の次の内容またはページへ移動する。(APPCOMMAND_BROWSER_FORWARD)
"BrowserHome" いいえ ユーザーの優先ホームページへ移動する。(APPCOMMAND_BROWSER_HOME)
"BrowserRefresh" いいえ 現在のページまたは内容を更新する。(APPCOMMAND_BROWSER_REFRESH)
"BrowserSearch" いいえ ユーザーの優先検索ページを呼び出す。(APPCOMMAND_BROWSER_SEARCH)
"BrowserStop" いいえ 現在のページまたは内容の読み込みを停止する。(APPCOMMAND_BROWSER_STOP)

3.16. 携帯電話キー

key 属性値 必須 典型的な用途(非規範)
"AppSwitch" いいえ Application switch キー。切り替え可能な最近のアプリ一覧を提供する。(KEYCODE_APP_SWITCH)
"Call" いいえ Call キー。(KEYCODE_CALL)
"Camera" いいえ Camera キー。(KEYCODE_CAMERA)
"CameraFocus" いいえ Camera focus キー。(KEYCODE_FOCUS)
"EndCall" いいえ End Call キー。(KEYCODE_ENDCALL)
"GoBack" いいえ Back キー。(KEYCODE_BACK)
"GoHome" いいえ Home キー。電話のメイン画面へ移動する。(KEYCODE_HOME)
"HeadsetHook" いいえ Headset Hook キー。(KEYCODE_HEADSETHOOK)
"LastNumberRedial" いいえ Last Number Redial キー。
"Notification" いいえ Notification キー。(KEYCODE_NOTIFICATION)
"MannerMode" いいえ manner mode 状態(silent、vibrate、ring、...)を切り替える。(KEYCODE_MANNER_MODE)
"VoiceDial" いいえ Voice Dial キー。

3.17. テレビキー

key 属性値 必須 典型的な用途(非規範)
"TV" いいえ テレビ視聴に切り替える。(KEYCODE_TV)
"TV3DMode" いいえ TV 3D Mode。(KEYCODE_3D_MODE)
"TVAntennaCable" いいえ アンテナ入力とケーブル入力を切り替える。(KEYCODE_TV_ANTENNA_CABLE)
"TVAudioDescription" いいえ 音声解説。(KEYCODE_TV_AUDIO_DESCRIPTION)
"TVAudioDescriptionMixDown" いいえ 音声解説ミキシング音量を下げる。(KEYCODE_TV_AUDIO_DESCRIPTION_MIX_DOWN)
"TVAudioDescriptionMixUp" いいえ 音声解説ミキシング音量を上げる。(KEYCODE_TV_AUDIO_DESCRIPTION_MIX_UP)
"TVContentsMenu" いいえ コンテンツメニュー。(KEYCODE_TV_CONTENTS_MENU)
"TVDataService" いいえ コンテンツメニュー。(KEYCODE_TV_DATA_SERVICE)
"TVInput" いいえ 外部 TV の入力モードを切り替える。(KEYCODE_TV_INPUT)
"TVInputComponent1" いいえ コンポーネント入力 #1 に切り替える。(KEYCODE_TV_INPUT_COMPONENT_1)
"TVInputComponent2" いいえ コンポーネント入力 #2 に切り替える。(KEYCODE_TV_INPUT_COMPONENT_2)
"TVInputComposite1" いいえ コンポジット入力 #1 に切り替える。(KEYCODE_TV_INPUT_COMPOSITE_1)
"TVInputComposite2" いいえ コンポジット入力 #2 に切り替える。(KEYCODE_TV_INPUT_COMPOSITE_2)
"TVInputHDMI1" いいえ HDMI 入力 #1 に切り替える。(KEYCODE_TV_INPUT_HDMI_1)
"TVInputHDMI2" いいえ HDMI 入力 #2 に切り替える。(KEYCODE_TV_INPUT_HDMI_2)
"TVInputHDMI3" いいえ HDMI 入力 #3 に切り替える。(KEYCODE_TV_INPUT_HDMI_3)
"TVInputHDMI4" いいえ HDMI 入力 #4 に切り替える。(KEYCODE_TV_INPUT_HDMI_4)
"TVInputVGA1" いいえ VGA 入力 #1 に切り替える。(KEYCODE_TV_INPUT_VGA_1)
"TVMediaContext" いいえ メディアコンテキストメニュー。(KEYCODE_TV_MEDIA_CONTEXT_MENU)
"TVNetwork" いいえ ネットワークを切り替える。(KEYCODE_TV_NETWORK)
"TVNumberEntry" いいえ 番号入力。(KEYCODE_TV_NUMBER_ENTRY)
"TVPower" いいえ 外部 TV の電源を切り替える。(KEYCODE_TV_POWER)
"TVRadioService" いいえ ラジオ。(KEYCODE_TV_RADIO_SERVICE)
"TVSatellite" いいえ 衛星。(KEYCODE_TV_SATELLITE)
"TVSatelliteBS" いいえ 放送衛星。(KEYCODE_TV_SATELLITE_BS)
"TVSatelliteCS" いいえ 通信衛星。(KEYCODE_TV_SATELLITE_CS)
"TVSatelliteToggle" いいえ 利用可能な衛星を切り替える。(KEYCODE_TV_SATELLITE_SERVICE)
"TVTerrestrialAnalog" いいえ 地上アナログ。(KEYCODE_TV_TERRESTRIAL_ANALOG)
"TVTerrestrialDigital" いいえ 地上デジタル。(KEYCODE_TV_TERRESTRIAL_DIGITAL)
"TVTimer" いいえ タイマー番組設定。(KEYCODE_TV_TIMER_PROGRAMMING)

3.18. メディアコントローラーキー

メディアコントローラー(たとえばテレビ、オーディオシステム、およびセットトップボックスのリモコン)の key 属性 値は、 家電技術仕様から一部派生している:

key 属性値 必須 典型的な用途(非規範)
"AVRInput" いいえ 外部 AVR(audio/video receiver)の入力モードを切り替える。(KEYCODE_AVR_INPUT)
"AVRPower" いいえ 外部 AVR(audio/video receiver)の電源を切り替える。(KEYCODE_AVR_POWER)
"ColorF0Red" いいえ 汎用色分けメディアファンクションキー。インデックス 0(赤)。(VK_COLORED_KEY_0, KEYCODE_PROG_RED)
"ColorF1Green" いいえ 汎用色分けメディアファンクションキー。インデックス 1(緑)。(VK_COLORED_KEY_1, KEYCODE_PROG_GREEN)
"ColorF2Yellow" いいえ 汎用色分けメディアファンクションキー。インデックス 2(黄)。(VK_COLORED_KEY_2, KEYCODE_PROG_YELLOW)
"ColorF3Blue" いいえ 汎用色分けメディアファンクションキー。インデックス 3(青)。(VK_COLORED_KEY_3, KEYCODE_PROG_BLUE)
"ColorF4Grey" いいえ 汎用色分けメディアファンクションキー。インデックス 4(グレー)。(VK_COLORED_KEY_4)
"ColorF5Brown" いいえ 汎用色分けメディアファンクションキー。インデックス 5(茶)。(VK_COLORED_KEY_5)
"ClosedCaptionToggle" いいえ Closed Captions の表示を切り替える。(VK_CC, KEYCODE_CAPTIONS)
"Dimmer" いいえ 状態間で切り替える、または循環することにより、デバイスの明るさを調整する。(VK_DIMMER)
"DisplaySwap" いいえ 映像ソースを入れ替える。(VK_DISPLAY_SWAP)
"DVR" いいえ Digital Video Recorder を選択する。(KEYCODE_DVR)
"Exit" いいえ 現在のアプリケーションを終了する。(VK_EXIT)
"FavoriteClear0" いいえ favorite 0 として保存された番組または内容を消去する。(VK_CLEAR_FAVORITE_0)
"FavoriteClear1" いいえ favorite 1 として保存された番組または内容を消去する。(VK_CLEAR_FAVORITE_1)
"FavoriteClear2" いいえ favorite 2 として保存された番組または内容を消去する。(VK_CLEAR_FAVORITE_2)
"FavoriteClear3" いいえ favorite 3 として保存された番組または内容を消去する。(VK_CLEAR_FAVORITE_3)
"FavoriteRecall0" いいえ favorite 0 として保存された番組または内容を選択(呼び出し)する。(VK_RECALL_FAVORITE_0)
"FavoriteRecall1" いいえ favorite 1 として保存された番組または内容を選択(呼び出し)する。(VK_RECALL_FAVORITE_1)
"FavoriteRecall2" いいえ favorite 2 として保存された番組または内容を選択(呼び出し)する。(VK_RECALL_FAVORITE_2)
"FavoriteRecall3" いいえ favorite 3 として保存された番組または内容を選択(呼び出し)する。(VK_RECALL_FAVORITE_3)
"FavoriteStore0" いいえ 現在の番組または内容を favorite 0 として保存する。(VK_STORE_FAVORITE_0)
"FavoriteStore1" いいえ 現在の番組または内容を favorite 1 として保存する。(VK_STORE_FAVORITE_1)
"FavoriteStore2" いいえ 現在の番組または内容を favorite 2 として保存する。(VK_STORE_FAVORITE_2)
"FavoriteStore3" いいえ 現在の番組または内容を favorite 3 として保存する。(VK_STORE_FAVORITE_3)
"Guide" いいえ 番組または内容ガイドの表示を切り替える。(VK_GUIDE, KEYCODE_GUIDE)
"GuideNextDay" いいえ ガイドが有効で表示されている場合、次の日の内容を表示する。(VK_NEXT_DAY)
"GuidePreviousDay" いいえ ガイドが有効で表示されている場合、前の日の内容を表示する。(VK_PREV_DAY)
"Info" いいえ 現在選択されているコンテキストまたはメディアに関する情報の表示を切り替える。(VK_INFO, KEYCODE_INFO)
"InstantReplay" いいえ インスタントリプレイを切り替える。(VK_INSTANT_REPLAY)
"Link" いいえ 利用可能かつ適切であれば、リンクされた内容を起動する。(VK_LINK)
"ListProgram" いいえ 現在の番組を一覧表示する。(VK_LIST)
"LiveContent" いいえ 現在利用可能なライブ内容または番組の一覧表示を切り替える。(VK_LIVE)
"Lock" いいえ 現在の内容または番組をロックまたはロック解除する。(VK_LOCK)
"MediaApps" いいえ メディアアプリケーションの一覧を表示する: オーディオ/ビデオプレイヤーおよび画像ビューア。(VK_APPS)

このキー値を、"ContextMenu" として符号化される Windows の VK_APPS / VK_CONTEXT_MENU キーと混同しないこと。

"MediaAudioTrack" いいえ 音声トラックキー。(KEYCODE_MEDIA_AUDIO_TRACK)
"MediaLast" いいえ 以前に選択されたチャンネルまたはメディアを選択する。(VK_LAST, KEYCODE_LAST_CHANNEL)
"MediaSkipBackward" いいえ 次の内容または番組へ後方にスキップする。(KEYCODE_MEDIA_SKIP_BACKWARD)
"MediaSkipForward" いいえ 次の内容または番組へ前方にスキップする。(VK_SKIP, KEYCODE_MEDIA_SKIP_FORWARD)
"MediaStepBackward" いいえ 次の内容または番組へ後方にステップする。(KEYCODE_MEDIA_STEP_BACKWARD)
"MediaStepForward" いいえ 次の内容または番組へ前方にステップする。(KEYCODE_MEDIA_STEP_FORWARD)
"MediaTopMenu" いいえ メディアトップメニュー。(KEYCODE_MEDIA_TOP_MENU)
"NavigateIn" いいえ 内側へナビゲートする。(KEYCODE_NAVIGATE_IN)
"NavigateNext" いいえ 次のキーへナビゲートする。(KEYCODE_NAVIGATE_NEXT)
"NavigateOut" いいえ 外側へナビゲートする。(KEYCODE_NAVIGATE_OUT)
"NavigatePrevious" いいえ 前のキーへナビゲートする。(KEYCODE_NAVIGATE_PREVIOUS)
"NextFavoriteChannel" いいえ 次のお気に入りチャンネル(お気に入りリスト内)へ循環する。(VK_NEXT_FAVORITE_CHANNEL)
"NextUserProfile" いいえ 次のユーザープロファイルへ循環する(複数のユーザープロファイルがある場合)。(VK_USER)
"OnDemand" いいえ オンデマンド内容または番組にアクセスする。(VK_ON_DEMAND)
"Pairing" いいえ デバイスをペアリングするための Pairing キー。(KEYCODE_PAIRING)
"PinPDown" いいえ ピクチャーインピクチャーウィンドウを下へ移動する。(VK_PINP_DOWN)
"PinPMove" いいえ ピクチャーインピクチャーウィンドウを移動する。(VK_PINP_MOVE)
"PinPToggle" いいえ ピクチャーインピクチャーウィンドウの表示を切り替える。(VK_PINP_TOGGLE)
"PinPUp" いいえ ピクチャーインピクチャーウィンドウを上へ移動する。(VK_PINP_UP)
"PlaySpeedDown" いいえ メディア再生速度を下げる。(VK_PLAY_SPEED_DOWN)
"PlaySpeedReset" いいえ 再生を通常速度にリセットする。(VK_PLAY_SPEED_RESET)
"PlaySpeedUp" いいえ メディア再生速度を上げる。(VK_PLAY_SPEED_UP)
"RandomToggle" いいえ ランダムメディアまたは内容のシャッフルモードを切り替える。(VK_RANDOM_TOGGLE)
"RcLowBattery" いいえ 物理キーではないが、このキーコードはリモコンの電池残量が少ない場合に送信される。(VK_RC_LOW_BATTERY)
"RecordSpeedNext" いいえ メディア録画速度を切り替える、または循環させる。(VK_RECORD_SPEED_NEXT)
"RfBypass" いいえ RF(radio frequency)入力バイパスモードを切り替える(RF 入力を RF 出力へ直接通す)。(VK_RF_BYPASS)
"ScanChannelsToggle" いいえ チャンネルスキャンモードを切り替える。(VK_SCAN_CHANNELS_TOGGLE)
"ScreenModeNext" いいえ 表示画面モードを次に利用可能なモードへ進める。(VK_SCREEN_MODE_NEXT)
"Settings" いいえ デバイス設定画面の表示を切り替える。(VK_SETTINGS, KEYCODE_SETTINGS)
"SplitScreenToggle" いいえ 分割画面モードを切り替える。(VK_SPLIT_SCREEN_TOGGLE)
"STBInput" いいえ 外部 STB(set top box)の入力モードを切り替える。(KEYCODE_STB_INPUT)
"STBPower" いいえ 外部 STB(set top box)の電源を切り替える。(KEYCODE_STB_POWER)
"Subtitle" いいえ 利用可能であれば字幕表示を切り替える。(VK_SUBTITLE)
"Teletext" いいえ 利用可能であれば teletext の表示を切り替える(VK_TELETEXT, KEYCODE_TV_TELETEXT)。
"VideoModeNext" いいえ ビデオモードを次に利用可能なモードへ進める。(VK_VIDEO_MODE_NEXT)
"Wink" いいえ デバイスが何らかの方法で自身を識別するようにする。たとえば、音声的または視覚的に。(VK_WINK)
"ZoomToggle" いいえ 全画面表示と拡大縮小された内容との間で切り替える、または拡大率を変更する。(VK_ZOOM, KEYCODE_TV_ZOOM_MODE)

メディアコントローラー標準で定義されるキーの一部には、 この仕様の他の節で定義された適切なキーがすでに存在する。次の 表は、これらのキーがサポートされる場合に使用しなければならないキー値を要約する:

key 属性値 必須 典型的な用途(非規範)
"AudioVolumeDown" いいえ オーディオ音量を下げる。(VK_VOLUME_DOWN)
"AudioVolumeUp" いいえ オーディオ音量を上げる。(VK_VOLUME_UP)
"AudioVolumeMute" いいえ ミュート状態と前の音量レベルとの間で切り替える。(VK_VOLUME_MUTE)
"BrowserBack" いいえ 現在の履歴内の前の内容またはページへ移動する。(VK_BACK)
"BrowserForward" いいえ 現在の履歴内の次の内容またはページへ移動する。(VK_FORWARD)
"ChannelDown" いいえ 次の(数値的または論理的に)低いチャンネルを選択する。(VK_CHANNEL_DOWN)
"ChannelUp" いいえ 次の(数値的または論理的に)高いチャンネルを選択する。(VK_CHANNEL_UP)
"ContextMenu" はい 画面上メニューの表示を切り替える。(VK_MENU)
"Eject" いいえ リムーバブルメディアの状態を、取り出し(開く)と挿入(閉じる)との間で切り替える。(VK_EJECT_TOGGLE)
"End" はい End キー。キーボード入力とともに使用され、内容の末尾へ移動するため。(VK_GO_TO_END)
"Enter" はい Enter キー。現在の選択を有効化する、または現在の入力を受け入れるため。(VK_SELECT)
"Home" はい Home キー。キーボード入力とともに使用され、内容の先頭へ移動するため。(VK_GO_TO_START)
"MediaFastForward" いいえ 通常より速い速度での前方再生を開始または継続する、またはすでに早送り中であれば 速度を上げる。(VK_FAST_FWD)
"MediaPlay" いいえ 現在通常速度で再生されていない場合、通常速度でのメディア再生を開始または継続する。 (VK_PLAY)
"MediaPlayPause" いいえ メディアを再生状態と一時停止状態の間で切り替える。(VK_PLAY_PAUSE)
"MediaRecord" いいえ 現在選択されているメディアの録画を開始または再開する。(VK_RECORD)
"MediaRewind" いいえ 通常より速い速度での逆再生を開始または継続する、またはすでに巻き戻し中であれば 速度を上げる。(VK_REWIND)
"MediaStop" いいえ まだ停止していない場合、メディアの再生、一時停止、早送り、巻き戻し、または録画を停止する。(VK_STOP)
"MediaPause" いいえ 現在再生中のメディアを一時停止する。(VK_PAUSE)
"MediaTrackNext" いいえ 次のメディアまたは番組トラックへシークする。(VK_TRACK_NEXT)
"MediaTrackPrevious" いいえ 前のメディアまたは番組トラックへシークする。(VK_TRACK_PREV)
"Power" いいえ 電源状態を切り替える。(VK_POWER)
"Unidentified" はい このキー値は、ハードウェア、プラットフォーム、またはソフトウェアの制約により、 実装が他のキー値を識別できない場合に使用される。(VK_UNDEFINED)

4. アクセシビリティ

この仕様は、key 属性で使用するために有効な値の集合を単に定義する。したがって、アクセシビリティ上の懸念を持つ 機能を導入しない。

FAST checklist は完了しており、この仕様に 適用されるものはない。

FAST checklist 項目「技術が国際化サポートを提供する場合」に関連する注: この仕様は本質的に、異なる言語またはレイアウトのキーボードなど、国際的なハードウェアをサポートする key 値を定義する。また、人間可読な名前("Shift"、"Control"、"Home"、"ArrowLeft" など)が与えられた 多くの特殊キーも定義する。

これらの特殊キー値は、特殊キーを検出するコードをより理解しやすくできるように、 人間可読な文字列として定義される。これらの値はユーザーに直接公開されることを意図していないが、 それを妨げるものはない。これらの値を公開することを選ぶアプリは、 表示のためにこれらの文字列を翻訳することが適切かどうかを判断する必要がある (例: フランス語ユーザー向けに "Backspace" を "Suppr. arrière" と表示する)。

5. I18n

short I18n checklist は完了しており、いずれの項目も適用されない。

6. セキュリティ考慮事項

Security and Privacy Self-Review Questionairre は、次の注記とともに完了している:

key 属性に関連するセキュリティ上の懸念は、[UIEvents] 仕様で扱われる。

7. プライバシー考慮事項

Security and Privacy Self-Review Questionairre は、次の注記とともに完了している:

key 属性に関連するプライバシー上の懸念は、[UIEvents] 仕様で扱われる。

8. 謝辞

長年にわたり、DOM Working Group および WebApps Working Group の多くの参加者を含む多くの人々が、DOM KeyboardEvent 仕様に貢献した。現在の key 値の集合は、 その期間にわたって多くの提案と変種を反復した結果である。 特に、次の参加者の貢献に感謝する:

Gary Kacmarcik (Google), Masayuki Nakano (Mozilla) and Travis Leithead (Microsoft).

適合性

文書 規約

適合性要件は、記述的な表明と RFC 2119 用語の組み合わせで表現される。 この文書の規範部分におけるキーワード “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, および “OPTIONAL” は、 RFC 2119 で説明されるように解釈される。 ただし、読みやすさのため、 これらの語はこの仕様ではすべて大文字で現れるとは限らない。

この仕様のすべてのテキストは、非規範であると明示的に示された節、例、および注を除き、規範である。 [RFC2119]

この仕様における例は、“for example” という語で導入されるか、 または次のように class="example" により 規範テキストから分離される:

これは参考例の例である。

参考注は “Note” という語で始まり、 次のように class="note" により 規範テキストから分離される:

注、これは参考注である。

適合 アルゴリズム

アルゴリズムの一部として命令形で表現された要件 (たとえば "strip any leading space characters" または "return false and abort these steps") は、そのアルゴリズムを導入する際に使用されたキーワード ("must", "should", "may" など)の意味で解釈される。

アルゴリズムまたは特定の手順として表現された適合性要件は、 最終結果が等価である限り、 どのような方法でも実装できる。 特に、この仕様で定義されるアルゴリズムは、 理解しやすいことを意図しており、 性能が高いことを意図していない。 実装者には最適化が推奨される。

索引

この仕様で定義される 用語

参照により定義される 用語

参考文献

規範参考文献

[RFC2119]
S. Bradner. RFC において要件レベルを 示すために用いるキーワード. 1997年3月. Best Current Practice. URL: https://datatracker.ietf.org/doc/html/rfc2119
[UAX15]
Ken Whistler. Unicode 正規化 形式. 2024年8月14日. Unicode Standard Annex #15. URL: https://www.unicode.org/reports/tr15/tr15-56.html
[UIEvents]
Gary Kacmarcik; Travis Leithead. UI Events. 2024年 9月7日. WD. URL: https://www.w3.org/TR/uievents/
[UIEvents-Code]
Travis Leithead; Gary Kacmarcik. UI Events KeyboardEvent code Values. 2023年5月30日. CR. URL: https://www.w3.org/TR/uievents-code/
[Unicode]
Unicode 標準. URL: https://www.unicode.org/versions/latest/

参考参考文献

[AndroidKeycode]
Android KeyEvent. URL: http://developer.android.com/reference/android/view/KeyEvent.html
[DASE]
ATSC A/100-2, DTV Application Software Environment Level 1 (DASE-1) Part 2: Declarative Applications and Environment. 2003年3月9日. URL: http://atsc.org/standard/a100-dtv-application-software-environment-level-1-dase-1/
[ISO9995-1]
ISO/IEC 9995-1:2009 Information technology -- Keyboard layouts for text and office systems -- Part 1: General principles governing keyboard layouts. URL: http://www.iso.org/iso/home/store/catalogue_tc/catalogue_detail.htm?csnumber=51645
[KeyEventJava]
Java™ Platform, Standard Edition 6 API Specification, Class java.awt.events.KeyEvent. URL: http://docs.oracle.com/javase/6/docs/api/java/awt/event/KeyEvent.html
[KeysNet]
.NET Framework 4.5 Class Library, Keys Enumeration. URL: http://msdn.microsoft.com/en-us/library/system.windows.forms.keys.aspx
[OCAP]
Open Cable Application Platform 1.1.3. 2010年6月3日. URL: https://apps.cablelabs.com/specification/opencable-application-platform-ocap/
[WEB4CE]
ANSI/CTA-2014-B, Web-based Protocol and Framework for Remote User Interface on UPnP Networks and the Internet (Web4CE). 2011年1月. URL: https://shop.cta.tech/products/web-based-protocol-and-framework-for-remote-user-interface-on-upnp-networks-and-the-internet
[WmAppCommand]
MSDN WM_APPCOMMAND message. URL: https://msdn.microsoft.com/en-us/library/windows/desktop/ms646275(v=vs.85).aspx