HTMLElement.focus()

在此页

句法
范例
规范
注意事项
浏览器兼容性
另请参阅
相关话题

HTMLElement.focus() method sets focus on the specified element, if it can be focused. The focused element is the element which will receive keyboard and similar events by default.

句法

element.focus(options); // Object parameter

参数

选项 可选

preventScroll 可选: A Boolean value indicating whether or not the browser should scroll the document to bring the newly-focused element into view. A value of false for preventScroll (the default) means that the browser will scroll the element into view after focusing it. If preventScroll 被设为 true , no scrolling will occur.

范例

Focus on a text field

JavaScript

focusMethod = function getFocus() {
  document.getElementById("myTextField").focus();
}

HTML

<input type="text" id="myTextField" value="Text field.">
<p></p>
<button type="button" onclick="focusMethod()">Click me to focus on the text field!</button>

结果

Focus on a button

JavaScript

focusMethod = function getFocus() {
  document.getElementById("myButton").focus();
}

HTML

<button type="button" id="myButton">Click Me!</button>
<p></p>
<button type="button" onclick="focusMethod()">Click me to focus on the button!</button>

结果

Focus with focusOption

JavaScript

focusScrollMethod = function getFocus() {
  document.getElementById("myButton").focus({preventScroll:false});
}
focusNoScrollMethod = function getFocusWithoutScrolling() {
  document.getElementById("myButton").focus({preventScroll:true});
}

HTML

<button type="button" onclick="focusScrollMethod()">Click me to focus on the button!</button>
<button type="button" onclick="focusNoScrollMethod()">Click me to focus on the button without scrolling!</button>
<div id="container" style="height: 1000px; width: 1000px;">
<button type="button" id="myButton" style="margin-top: 500px;">Click Me!</button>
</div>

结果

规范

规范	状态	注释
HTML 实时标准 The definition of 'focus' in that specification.	实时标准
HTML 5.1 The definition of 'focus' in that specification.	推荐
HTML5 The definition of 'focus' in that specification.	推荐
DOM (文档对象模型) 2 级 HTML 规范 The definition of 'focus' in that specification.	过时
DOM (文档对象模型) 1 级规范 The definition of 'focus' in that specification.	过时

注意事项

若调用 HTMLElement.focus() from a mousedown event handler, you must call event.preventDefault() to keep the focus from leaving the HTMLElement
Behaviour of the focus in relation to different HTML features like tabindex or shadow dom , which previously remained under-specified, were recently updated (as October of 2019). Checkout WHATWG blog for more info.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`focus`	Chrome 1	Edge 12	Firefox 5	IE 9	Opera 8	Safari 3	WebView Android 4.4	Chrome Android 18	Firefox Android 5	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0
`preventScroll` Boolean option	Chrome 64	Edge ≤79	Firefox 68	IE ?	Opera 51	Safari ?	WebView Android 64	Chrome Android 64	Firefox Android 68	Opera Android 47	Safari iOS ?	Samsung Internet Android 9.0

图例

完整支持
兼容性未知 ?

另请参阅

DOM method HTMLElement.blur() to remove the focus from an element.
document.activeElement to know which is the currently focused element.

元数据

最后修改： Dec 6, 2019

在此页

句法

参数

范例

Focus on a text field

JavaScript

HTML

结果

Focus on a button

JavaScript

HTML

结果

Focus with focusOption

JavaScript

HTML

结果

规范

注意事项

浏览器兼容性

图例

另请参阅

相关话题