`autofocus` 属性 (HTML、HTML DOM)

[1] HTML のフォーム制御子の autofocus 属性は、焦点を自動的にその制御子に与えるべきことを示します。

[3] 内容属性

状態: WHATWG WD
要素型: フォーム制御子
type: hidden と outputhttp://www.w3.org/1999/xhtml を除く
属性名: autofocus
属性値: ブール型属性 (>>4)
既定値: 偽 (>>5)

[9] DOM属性

状態: WHATWG WD
界面: HTMLInputElement, HTMLTextAreaElement, HTMLSelectElement, HTMLButtonElement
属性名: autofocus
型: boolean

[2] 仕様書:

Web Forms 2.0
- 2.10. The autofocus attribute IW:WF2:"#the-autofocus"

内容属性値

[4] 属性値を設定する場合は、 autofocus とするべきです。 WF2 2.10

[5]

DOM 属性値

[10] 取得 DOM属性 autofocus は、内容属性 autofocus が存在していれば、属性値に関わらず、 true が返される値としなければなりません。内容属性が存在しない場合は false としなければなりません。 WF2 2.10

[11] 設定 DOM属性 autofocus は、true と設定された時には、内容属性 autofocus の属性値は autofocus と設定しなければなりません。 false と設定された時には、内容属性 autofocus は削除しなければなりません。 WF2 2.10

HTML 直列化

[13] (XHTML ではない) HTML では、

<input autofocus="autofocus">

と同じ意味で、

<input autofocus>

と省略することができます。 WF2 2.10

レンダリング

[6] 利用者エージェントは、フォーム制御子が文書に挿入された時、 autofocus 属性が設定されているかどうかを確認しなければなりません。利用者エージェントは、 autofocus 属性が設定されており、 disabled ではなく、その環境で通常焦点を当てることができる種類のものであれば、その制御子の focus メソッドが呼ばれた場合と同じように焦点を授与するべきです。閲覧領域を持つ利用者エージェントは、焦点を当てることが可能かどうかに関わらず、そのフォーム制御子が可視になるように文書をスクロールするべきです。 WF2 2.10

[8] 利用者エージェントは、利用者が焦点を移して欲しくない場合にこの属性を無視して構いません。例えば、利用者が入力を開始したら、それ以後 autofocus は無視して構いません。 WF2 2.10

[14] Webブラウザの窓が焦点を失っている時に autofocus が指定されていても、窓が焦点を得なければならないわけではありません。 WF2 2.10

[20] 履歴の移動で bfcache から復元した際は、 autofocus ではなく、以前の表示の際のフォーカスを復元するべきと思われます。

誤り処理

[7] 著者は、複数の有効な要素に autofocus 属性を設定してはなりません。複数の要素が autofocus な場合、順に >>6 のように処理されるので、文書の読込み直後には文書順で最後の焦点を当てられるフォーム制御子が焦点を得ることになります。 WF2 2.10

メモ

[15] HTML5 Revision Tracker (2010-07-30 07:56:25 +09:00 版) http://html5.org/tools/web-apps-tracker?from=5221&to=5222

[16] [whatwg] Two propositions for the autofocus attribute (2010-08-25 09:09:30 +09:00 版) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2010-August/028124.html

[17] [whatwg] Autofocus readonly Input Elements ( (2011-09-24 09:56:48 +09:00 版)) http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-September/033284.html

[18] Web Applications 1.0 r8152 Make autofocus= not force the 'load' event to be delayed by style computation.]] ( (2013-08-22 14:23:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=8151&to=8152

[19] IRC logs: freenode / #whatwg / 20130822 ( (2013-08-26 10:03:00 +09:00 版)) http://krijnhoetmer.nl/irc-logs/whatwg/20130822

[21] Queue a task to run all the autofocusing steps (domenic著, 2018-03-07 14:32:39 +09:00) https://github.com/whatwg/html/commit/185190cac859144cfcd78248b906f3adae1f0594

[22] Autofocus has weird racy behavior · Issue #3467 · whatwg/html (2018-03-08 15:24:37 +09:00) https://github.com/whatwg/html/issues/3467

[23] Queue a task to run all the autofocusing steps by domenic · Pull Request #3488 · whatwg/html (2018-03-08 15:26:31 +09:00) https://github.com/whatwg/html/pull/3488

[26] Update autofocus processing algorithm (tkent-google著, 2019-09-04 01:07:59 +09:00) https://github.com/whatwg/html/commit/2d783dbb7c6c0343b4850f3be935e893a1de5582

[27] Autofocus spec should probably allow browsers to delay running the focusing steps, maybe? · Issue #3551 · whatwg/html (2020-08-31 17:50:18 +09:00) https://github.com/whatwg/html/issues/3551

[28] Update autofocus algorithm · Issue #4645 · whatwg/html (2020-08-31 17:51:45 +09:00) https://github.com/whatwg/html/issues/4645

[29] Update autofocus processing algorithm by tkent-google · Pull Request #4763 · whatwg/html (2020-08-31 17:52:03 +09:00) https://github.com/whatwg/html/pull/4763

[30] Change the timing of "flush autofocus candidates" (tkent-google著, 2019-10-18 10:23:25 +09:00) https://github.com/whatwg/html/commit/74b61242c716876bad8e24fe358796d31b9ecae1

[31] Prevent double-focusing with autofocus="" inside <dialog> (tkent-google, 2019-11-08 03:58:13 +09:00, 2021-03-08T07:27:26.000Z) https://github.com/whatwg/html/commit/b48bb2238269d90ea4f455a52cdf29505aff3df0

[32] dialog, autofocus: Do not enqueue elements with autofocus attribute i… by tkent-google · Pull Request #4918 · whatwg/html (2021-03-08T07:28:03.000Z) https://github.com/whatwg/html/pull/4918

[33] Autofocus element in a <dialog> tries to get focus twice · Issue #4788 · whatwg/html (2021-03-08T07:28:50.000Z) https://github.com/whatwg/html/issues/4788

[34] Make autofocus="" work with delegatesFocus and <area> (tkent-google, 2019-11-12 01:44:20 +09:00, 2021-03-16T07:25:17.000Z) https://github.com/whatwg/html/commit/bcd5d619063c809f297c1b8dfd13146ee2993371

[35] delegatesFocus doesn't work well with autofocus · Issue #5027 · whatwg/html (2021-03-16T07:26:00.000Z) https://github.com/whatwg/html/issues/5027

[36] focus: autofocus should work with shadow hosts with delegatesFocus an… by tkent-google · Pull Request #5059 · whatwg/html (2021-03-16T07:27:01.000Z) https://github.com/whatwg/html/pull/5059

autofocus 属性 (HTML、HTML DOM)