Tabキーのキーコード

Tabは、Shiftの有無に関係なく、event.key「Tab」、event.code「Tab」、keyCode 9を送ります。

すべての値の一覧

Tabの値
キーevent.codeevent.keykeyCodeevent.location
TabTabTab90(標準)

keyCodeは、WindowsのChromeとEdgeが送る値です。Macの列(MacのChromeとSafari)とFirefoxの列には、違う数値だけを表示しています。システムによって違うキーもあり、下の説明に書いています。event.whichは、いつもkeyCodeと同じ数値です。event.keyは、US配列でShiftなしの値です。

ここで押してみる

ここをクリックしてから、Tabを押してください

キーボードだけで操作していますか?キーの枠から出るには、Escを押してからTabを押してください。

Tabに反応するコード

おすすめ:event.keyで判定
document.addEventListener('keydown', (event) => {
  if (event.key === 'Tab') {
    // ここに処理を書きます
  }
});
キーの位置で判定:event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Tab') {
    // ここに処理を書きます
  }
});
keyCodeを使う古いコード(非推奨)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 9) {
    // ここに処理を書きます
  }
});

どの値を使うか

event.key === 'Tab'を確かめます。Tabキーは1つだけで、どの配列でも同じ値を送ります。event.codeも"Tab"です。

Shift + Tabでも"Tab"が送られます。Shiftでキーの名前は変わりません。2つを見分けるにはevent.shiftKeyを確かめます。

keyCode 9はどのブラウザでもまだ届きますが、非推奨です。

よくあるつまずき

keyupが別の要素に届く

Tabはkeydownでフォーカスを移します。そのため、keydownはフォーカスが移る前の入力欄に、keyupは移った先の入力欄に届きます。入力欄にkeyupハンドラーを付けると、Tabでその欄に入るたびにTabを受け取ります。Tabはkeydownで処理してください。

キーボードの利用者がウィジェットから出られなくなる

TabでpreventDefault()を呼ぶと、フォーカスが移らず、キーボードの利用者は抜け出せません。ほかに抜け出す方法がなければ、WCAG 2.1.2「キーボードトラップなし」の基準を満たしません。Tabを止めるのは、開いている間はフォーカスを中に留めるモーダルダイアログなど、正当な理由があるときだけにしてください。その場合は、Escや閉じるボタンなど、わかりやすい出口を用意します。

テキストエリアでTabを押すと、字下げされずに欄から出てしまう

それが既定の動作で、ほとんどのユーザーはそれを望んでいます。コードエディターでは、代わりにタブ文字を入れることもできます。

if (event.key === 'Tab' && !event.shiftKey) {
  event.preventDefault();
  textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}

キーコード確認ツールのように、抜け出す方法と組み合わせてください。先にEscを押すと、そのあとTabで先へ進めます。setRangeText()は元に戻す履歴に残りません。document.execCommand('insertText', false, '\t')なら残りますが、非推奨です。

Ctrl+TabとAlt+Tabがページに届かない

これらはブラウザとパソコンが使います。Ctrl + Tabはブラウザのタブを、Alt + Tab(MacではCmd + Tab)はアプリを切り替えます。ページにはCtrlかAltのkeydownが届き、そのあと何も届かないことがあります。ユーザーが戻ってきたとき、keyupが別のウィンドウに届いたため、修飾キーが押されたままに見えることがあります。windowのblurイベントで修飾キーの状態をリセットしてください。

SafariでTabがリンクやボタンを飛ばす

MacのSafariは、初期設定ではフォーム欄の間しか移動しません。option + Tabならすべての項目に移れます。または、Safariの「設定」→「詳細」で「Tabキーを押したときにWebページ上の各項目を強調表示」をオンにします。その設定をオンにしてタブ順を確かめてください。また、MacユーザーがTabだけでボタンにたどり着けるとは考えないでください。

タブ順

TabはHTMLの要素の順番に従います。tabindex="0"で要素をその順番に加え、tabindex="-1"で外します。正の数は避けてください。ほかのすべてより先に飛んでしまい、利用者を混乱させます。