autofocus
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年2月以降、すべてのブラウザーで利用可能です。
autofocus はグローバル SVG 属性で、文書に接続された後にフォーカスを受け取る要素を指定します。この属性は、その要素がすでにフォーカス可能でない場合は効果がありません。
autofocus 属性には、HTML 側にも対応する autofocus 属性があります。文書内で autofocus 属性を持てる要素は 1 つだけです。複数の要素に指定した場合は、最初の要素がフォーカスを受け取ります。
使用上のメモ
| 値 |
論理属性
|
|---|---|
| デフォルト値 | なし |
| アニメーション | 不可 |
値については、HTML の autofocus 属性の説明を参照してください。
アクセシビリティの注意事項
SVG 要素に自動でフォーカスを当てると、スクリーンリーダーを使う視覚障碍のある人や認知障碍のある人を混乱させることがあります。autofocus が設定されると、スクリーンリーダーは事前に警告することなく、利用者をフォーカス可能な要素へ「テレポート」させます。
autofocus 属性を使用する際は、アクセシビリティへの影響を慎重に検討してください。要素に自動でフォーカスを当てると、ページの読み込み時にスクロールが発生することがあります。また、一部のタッチデバイスでは、フォーカスによってソフトウェアキーボードが表示されることもあります。スクリーンリーダーは、フォーカスを受け取る要素のアクセシブル名を読み上げますが、その要素より前にある、より多くの文脈を与えるコンテンツは読み上げません。同様に、小さなデバイスで画面を見る利用者も、先行するコンテンツが与える文脈を見落としてしまいます。
仕様書
| 仕様書 |
|---|
| Scalable Vector Graphics (SVG) 2> # autofocusattribute> |
ブラウザーの互換性
関連情報
- SVG
tabindex属性 - HTML の
autofocus属性 SVGElement.autofocus