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 贡献者贡献。