autofocus
autofocus グローバル属性は論理属性で、ページ読み込み時、またはその要素が属する <dialog> が表示されたときに、その要素にフォーカスを当てるべきことを示す属性です。
html
<input name="q" autofocus />
文書またはダイアログ内の複数の要素に autofocus 属性を設定することはできません。複数の要素に適用された場合、最初のものにフォーカスが当たります。
メモ: autofocus 属性は、フォームコントロールだけでなく、すべての要素に適用されます。例えば、これは contenteditable の領域で使用されるかもしれません。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 79 | 79 | 110 | 15.4 | 79 | 16.4 | |
| DOM API | ||||||
| autofocus は HTMLElement のプロパティで、HTML の autofocus 属性を反映した論理値で、ページが読み込まれた時、または、 dialog 要素やポップオーバー属性が設定された要素の中で指定された場合は、ダイアログやポップオーバーが表示された時に、コントロールにフォーカスを当てるかどうかを表します。 | 79 | 79 | 110 | 15.4 | 79 | 15.4 |
| MathMLElement インターフェイスの autofocus プロパティには、autofocus HTML グローバル属性を反映した boolean 値が含まれます。これは、MathML 要素がダイアログやポップオーバーの中にある場合、ページがロードされた時、または要素が表示された時に MathML 要素にフォーカスを当てるかどうかを示します。 | 109 | 109 | 110 | 15.4 | 109 | 15.4 |
| SVGElement インターフェースの autofocus プロパティは autofocus HTML global 属性を反映した boolean 値を持つ。それは SVG 要素がダイアログやポップオーバーの中にある場合、ページがロードされた時、あるいは要素が表示された時に SVG 要素に焦点を合わせるべきかどうかを示す。 | 79 | 79 | 110 | 15.4 | 79 | 15.4 |
| その他 | ||||||
| autofocus global SVG 属性は、フォーカス可能な要素が文書に連結された後にフォーカスされるように定義する。この属性は、要素が既にフォーカス可能でない場合は何の効果もない。 | 79 | 79 | 110 | 15.4 | 79 | 15.4 |
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (79)
- <button>`、`<input>`、`<select>`、`<textarea>` 要素をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (79)
- <button>`、`<input>`、`<select>`、`<textarea>` 要素をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (110)
- <button>`、`<input>`、`<select>`、`<textarea>` 要素をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (15.4)
- <button>`、`<input>`、`<select>`、`<textarea>` 要素をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (79)
- <button>`、`<input>`、`<select>`、`<textarea>` 要素をサポートする。
- ハードウェアキーボードが接続されていない場合、`autofocus` 属性は何の効果も持ちません(例えば、`focus` イベントは発生せず、要素は `:focus` セレクタにマッチしません)。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (79)
- HTMLButtonElement`, `HTMLInputElement`, `HTMLSelectElement`, `HTMLTextAreaElement` をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (79)
- HTMLButtonElement`, `HTMLInputElement`, `HTMLSelectElement`, `HTMLTextAreaElement` をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (110)
- HTMLButtonElement`, `HTMLInputElement`, `HTMLSelectElement`, `HTMLTextAreaElement` をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (15.4)
- HTMLButtonElement`, `HTMLInputElement`, `HTMLSelectElement`, `HTMLTextAreaElement` をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (79)
- HTMLButtonElement`, `HTMLInputElement`, `HTMLSelectElement`, `HTMLTextAreaElement` をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (15.4)
- HTMLButtonElement`, `HTMLInputElement`, `HTMLSelectElement`, `HTMLTextAreaElement` をサポートする。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (110)
- SVGGraphicsElement` でのみサポートされる。
- このブラウザでは部分的にしか実装されていません
- このバージョンで機能が削除されました (110)
- SVGGraphicsElement` でのみサポートされる。
基本構文
<form>
<label>Search: <input type="search" autofocus placeholder="キーワード"></label>
<button type="submit">Search</button>
</form> ライブデモ
実務での使いどころ
-
autofocus の活用
autofocus グローバル属性は論理属性で、ページ読み込み時、またはその要素が属する <dialog> が表示されたときに、その要素にフォーカスを当てるべきことを示す属性です。
注意点
- 古いブラウザでは対応していない場合がある。
アクセシビリティ
- スクリーンリーダーでの読み上げを確認すること。