HTML autofocus 全域性屬性

Baseline 已廣泛支援

此功能已成熟，並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來，它已在各種瀏覽器中可用。

autofocus 全域性屬性是一個布林屬性，表示在頁面載入時，或者當它所屬的 <dialog> 顯示時，應該聚焦到哪個元素。

html

<input name="q" autofocus />

文件或對話方塊中最多隻能有一個元素擁有 autofocus 屬性。如果應用到多個元素上，第一個元素將獲得焦點。

注意： autofocus 屬性適用於所有元素，而不僅僅是表單控制元件。例如，它可能用於一個 contenteditable 區域。

可訪問性考慮

自動聚焦表單控制元件可能會讓使用螢幕閱讀器技術的視障人士以及有認知障礙的人感到困惑。當分配了 autofocus 時，螢幕閱讀器會在不事先警告使用者的情況下，“瞬移”使用者到表單控制元件。

在應用 autofocus 屬性時，請仔細考慮可訪問性。自動聚焦到控制元件可能會導致頁面在載入時滾動。焦點也可能導致某些觸控裝置上顯示動態鍵盤。雖然螢幕閱讀器會朗讀獲得焦點的表單控制元件的標籤，但螢幕閱讀器不會朗讀標籤之前的任何內容，而小裝置的視力正常的使用者同樣會錯過前面內容所建立的上下文。

規範
HTML # dom-fe-autofocus

此頁面最後修改於 2025年7月9日，由 MDN 貢獻者貢獻。