要素をアクティブ化したりフォーカスを与えたりするために著者が実装したキーボードショートカットを示します。
aria-keyshortcuts
属性の値は、コマンドやテキストボックスウィジェットをアクティブ化するために押すことができるキーボードショートカットのスペース区切りリストです。ショートカットで定義されるキーは、生成される文字ではなく、物理的に押されるキーを表します。各キーボードショートカットは、プラス記号("+")で区切られた1つ以上のトークンからなり、同時に押す必要がある修飾キー(0個以上)と、必ず1つだけの非修飾キーから構成されます。
著者は 必須として、修飾キーをUI Events KeyboardEvent key Values仕様 [uievents-key]
に正確に従って指定してください。例:"Alt", "Control", "Shift", "Meta",
"AltGraph"。MetaはAppleコンピュータのCommandキー、AltはOptionキーに相当します。
非修飾キーとして有効な名前は、"A", "B", "1", "2", "$", "Plus"(プラス記号), "Space"(スペースバー)などの印字可能文字、または UI Events
KeyboardEvent key Values仕様 [uievents-key]で定義された他の非修飾キーです。例:"Enter",
"Tab", "ArrowRight", "PageDown", "Escape",
"F1"など。"Space"(スペースバー)は仕様上例外で、spaceキーを' '
で指定すると空白文字扱いになるためです。
著者は 必須として、修飾キーがある場合は必ず先頭に記述し、必須の非修飾キーは最後に記述してください。修飾キーの順序自体は重要ではないため、"Alt+Shift+T"と"Shift+Alt+T"は同じですが、"T+Shift+Alt"は無効です(修飾キーが先頭でないため)。また、"Alt"だけでは非修飾キーがないため無効です。
アルファベットキーを指定する場合は大文字・小文字の違いは区別されません:"a" と "A" は同じです。
キーボードショートカットを実装する際は、想定するキーボードの種類や言語に応じて、予期せぬ動作を避けるよう注意してください。キーボードによって修飾キーの組み合わせや機能は大きく異なります。例えば、多くの修飾キーは記号入力や数字入力、言語切り替えなど他の機能と組み合わされます。
多くのキーボードでの衝突を避けるには、ASCII文字以外のキーを避けると良いです。数字や記号は修飾キーが必要な場合が多く、ショートカットで指定したキーが実際に生成されるキーと一致しないことがあります。例えばフランス語キーボードでは数字を入力するのにControlキーが必要なため、"Control+2"と指定すると曖昧になります。
修飾キーで生成される文字の場合、著者は 必須として、生成される文字ではなく実際に押すキーを指定してください。これにより、支援技術が正確に必要なキー操作を伝えられます。例えば、米国キーボードでパーセント記号
"%" は Shift+5 で入力できます。正しいショートカットは "Shift+5" です。"%", "Shift+%" は誤りです。ただし、国際キーボードで修飾なしで入力できる場合は
"%" も正しい場合があります。
ホスト言語で指定が違法または文字列終端になる場合、著者は 必須として、ホスト言語のエスケープシーケンスを使って指定してください。例えば、ダブルクォートはHTMLでは "Shift+'"
で指定できます。
有効なキーボードショートカットの例:
- "A"
- "Shift+Space"
- "Control+Alt+."
- "Control+Shift+'"
- "Alt+Shift+P Control+F"
- "Meta+C Meta+Shift+C"
ユーザーエージェントは必須として、aria-keyshortcuts
属性に応じてキーボード動作を変更してはなりません。著者は 必須として、スクリプトでキーボードイベントを処理しaria-keyshortcuts
を実装してください。この属性は、支援技術がユーザーにショートカットの存在を伝えるためのものです。
著者は 推奨として、すべてのユーザーがショートカットを発見できるようツールチップなどで明示することが望ましいです。また、無効化された要素に設定されたaria-keyshortcuts
は利用不可とする必須です。
著者は 推奨として、OSやユーザーエージェント、支援技術の機能を妨げるショートカットの実装は避けるべきです。どのキーを割り当てるか、どのコンテキスト・条件で利用可能かを慎重に検討してください。詳細は
WAI-ARIA作成ガイドのキーボードショートカットの章をご参照ください。