aria-keyshortcuts

キーボードショートカットは、ソフトウェアに事前にプログラムされたアクションを実行するように指示する 1 つまたは複数のキーの連続です。キーボードショートカットを使用すると、キーボードユーザーは、通常はメニューにアクセスしたり、タッチやマウスを使用したりする必要があるコマンドをキーボードで呼び出すことができます。aria-keyshortcuts プロパティは、属性が設定されている要素をアクティブにしたり、その要素にフォーカスを当てたりするために実装されているキーボードキーを定義します。

aria-keyshortcuts 属性は、ショートカットの存在を支援技術に公開し、ショートカットの存在をユーザーに伝えることができます。すべての ARIA 属性と同様に、ページの機能には影響しません。キーボードの動作は、JavaScript イベントハンドラーを介して追加する必要があります。

無効な要素に適用されたキーボードショートカットは無効にする必要があります。例えば、マウスユーザーに対して要素を無効にする場合は、キーボードショートカットユーザーに対しても無効にすることを忘れないでください。

全てのキーボードショートカットが、目の見えるユーザーに表示されるとともに、支援技術でも利用できるようにしてください。アプリケーションが複雑で、キーボードショートカット（「ホットキー」とも呼ばれます）が必要な場合は、アプリケーションのガイドツアー、ショートカットやその他のアクセシビリティ機能を説明するアクセシビリティページ、ショートカットチートシートページまたはダイアログポップアップ、またはキーボードショートカットが利用できることを知らせるその他の方法を含めてください。さらに、メニューやツールチップにショートカットを表示します。

aria-keyshortcuts 属性の値は、コマンドまたはテキストボックスウィジェットをアクティブにするために押すことができるキーの組み合わせのスペース区切りリストです。各キーの組み合わせには、0 個、1 個、または複数の修飾キーと、それに続く、同時に押すことができる 1 つの非修飾キーがプラス記号（「+」）で結合されて含まれます。属性値は大文字と小文字を区別しません。

有効なキーボードショートカットの例は次のとおりです:

aria-keyshortcuts="A"
aria-keyshortcuts="Shift+Space"
aria-keyshortcuts="Control+Alt+."
aria-keyshortcuts="Control+Shift+'"
aria-keyshortcuts="alt+shift+p control+f"
aria-keyshortcuts="Meta+C Meta+Shift+C"

修飾キーは、単独で使用しても効果がないキーです。修飾キーは、「Alt」、「Control」、「Shift」、「Meta」（Macでは Command キー）、または「AltGraph」（Mac では Option キー）と表記されます。

非修飾キーは、単独で使用すると、文字の入力、フォーカスの移動、または使用時にキーボードイベントの作成など、影響を与えるキーです。 1 つの文字を入力する非修飾キーには「P」、「z」、「.」などの文字が含まれます。

プラス記号はキーの組み合わせを記述する際に使用されるため、非修飾キーのように plus と記述されます。その他の記述される非修飾キーには、空白文字である Space、Tab、Enter、そして ArrowUp、PageUp、Escape などのアクションを引き起こす全ての文字が含まれます。

二重引用符内の二重引用符文字など、問題を引き起こす可能性のある文字を使用する場合は、その文字をエスケープします: Control+'。

各キーの組み合わせでは、修飾キーが最初にリストされている必要があります。可能なキーの組み合わせには、Control+P、Shift+Space、Q が含まれます。完全なショートカットでこれら 3 つの組み合わせ全てを順番に実行する必要がある場合は、aria-keyshortcuts="Control+P Shift+Space Q" と記述されます。キーの組み合わせに複数の修飾キーが含まれている場合、修飾キーの順序は重要ではありませんが、修飾キーは全て非修飾キーよりも前に来る必要があります。

これら 2 つの属性宣言は同等です。

aria-keyshortcuts="Shift+Control+V"
aria-keyshortcuts="control+shift+v"

テキストの大文字と小文字は関係ないことに注意してください。ただし、非修飾キーの順序は関係します。

非修飾キーは最後にある必要があるため、これら 2 つの属性宣言は無効です。

aria-keyshortcuts="V+Shift+Control"
aria-keyshortcuts="V+Control+Shift"

記載されているキーの組み合わせは、組み合わせたキーストロークの結果ではなく、ユーザーが押す必要のあるキーである必要があります。例えば、米国のキーボードで @ 記号が必要な場合、キーの組み合わせは "@" や "Shift+@" ではなく "Shift+2" と記述されます。

サイトやアプリケーションのアクセシビリティを向上させるには、「向上」がユーザー体験に悪影響を与えないようにするためのベストプラクティスがいくつかあります。悪い ARIA があるよりも ARIA がない方がよいということを覚えておいてください。

ブラウザー、支援技術、またはオペレーティングシステムのショートカットを上書きしないでください

キーボードショートカットを実装する場合、同じ目的で使用されている場合を除き、ブラウザー、支援技術、またはオペレーティングシステムで既に使用されているショートカットを作成しないようにしてください。例えば、ほとんどのユーザーエージェントは、印刷機能を開始するために "Control+P" を使用します。通常、ウェブアプリケーションでは、ブラウザーの機能を奪ってしまうため、「Control+P」ショートカットを作成しないでください。例外もあります。電子メールアプリケーションやドキュメントエディターなど、印刷が一般的なウェブアプリケーションでは、アプリケーション固有の印刷フローのためにブラウザーの "Control+P" 印刷機能を奪うことが予想されます。

生産性アプリケーションの HTML バージョンを作成するのでない限り、キーボードショートカットの実装は避けたほうがよいでしょう。オペレーティングシステムまたはブラウザーのキーボードショートカットを上書きすると、支援技術を使用していないユーザーにとっては煩わしい場合があり、スクリーンリーダーのキーボード機能を上書きすると、支援技術を使用しているユーザーのアクセスを完全に遮断してしまう場合があります。キーボードショートカットを作成する必要がある場合は、1 文字のキーボードショートカットや一般的なスクリーンリーダーのキーボードショートカットは使用しないでください。

言語とキーボードの違いを考慮する

利用可能なキーボードの多様性と、さまざまなキーボード言語設定を考慮してください。修飾キーは、言語固有の一般的な句読点記号や数字を作成するためによく使用されます。例えば、キーボード言語設定がフランス語（フランス）に設定されている場合は、数字には Shift キーを使用します。

代わりに HTML を使用しないでください

aria-keyshortcuts 属性は、現在の要素のキーボードショートカットを生成する 問題のある HTML accesskey 属性と非常によく似ています。accesskey が要素に対して定義されている場合、ブラウザーは修飾キーを定義し、スクリプトを必要とせずにショートカットの処理を全て行います。全てのブラウザーとオペレーティングシステムの組み合わせには、accesskey 属性で設定された非修飾キー用の独自の修飾キーがあります。オペレーティングシステム、支援技術、ブラウザーの 1 つの組み合わせで機能するものが、他の組み合わせでは機能しない可能性があります。aria-keyshortcuts では、修飾子キーがキーの組み合わせの属性値リストに含まれており、その機能はスクリプト化する必要があります。

<p>
  Press the
  <strong><u>S</u></strong
  >tress reliever to relax!
</p>
<button accesskey="s">Stress reliever</button>

この例では、非修飾文字を強調表示することで、ショートカットの存在が目の見えるユーザーによくわかるようにしました。

accesskey 属性の目的は aria-keyshortcuts の意図と一致していますが、ネイティブでそれを実行するには accesskey には多くの問題があります。これらの問題があるため、ほとんどの汎用ウェブサイトやウェブアプリでは accesskey を使用しないことが一般的に推奨されています。

ブラウザのサポートが不十分であることに加えて、aria-keyshortcuts の場合と同じ懸念が accesskey にも生じます。

• アクセスキーの値は、システムまたはブラウザーのキーボードショートカット、あるいは支援技術の機能と競合する可能性があります。
• 特に国際化が懸念される場合、特定のキー値が特定のキーボードに存在しないことがあります。そのため、特定の言語に適応すると、さらに問題が発生する可能性があります。
• 数字に依存する値は、数字がトリガーする機能と論理的な関連を持たない場合、認知上の問題を抱えている個人を混乱させる可能性があります。
• ショートカットが存在することをユーザーに通知して、その機能を認識させてください。システムにこの機能についてユーザーに通知する方法がない場合、ユーザーは誤ってショートカットをアクティブにする可能性があります。

<string>

押すとアクションが実行されるキーの組み合わせをスペースで区切ったリスト。

この例では、要素の aria-keyshortcuts 属性は「Alt+Shift+A」に設定されています。

<a href="#content" aria-keyshortcuts="Alt+Shift+A">Skip to content</a>

Element.ariaKeyShortcuts

Element インターフェイスの一部である ariaKeyShortcuts プロパティは、aria-keyshortcuts 属性の値を反映します。

ElementInternals.ariaKeyShortcuts

ElementInternals インターフェイスの一部である ariaKeyShortcuts プロパティは、aria-keyshortcuts 属性の値を反映します。

すべてのロールで使用されます。

• ARIA Authoring Practices の Keyboard Shortcuts セクション
• HTML accesskey 属性
• Issues with accesskey