Window:focus 事件

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

focus 事件在元素获得焦点时触发。

focus 的反向事件是 blur

此事件不可取消,也不会冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("focus", (event) => { })

onfocus = (event) => { }

事件类型

一个 FocusEvent。继承自 UIEventEvent

Event UIEvent FocusEvent

事件属性

此接口还继承了其父级 UIEvent 的属性,以及间接继承自 Event 的属性。

FocusEvent.relatedTarget

一个 EventTarget,代表此事件的次要目标。在某些情况下(例如,在页面中或页面外进行选项卡切换时),出于安全原因,此属性可能设置为 null

示例

实时示例

此示例在文档失去焦点时更改其外观。它使用 addEventListener() 来监控 focusblur 事件。

HTML

html
<p id="log">Click on this document to give it focus.</p>

CSS

css
.paused {
  background: #dddddd;
  color: #555555;
}

JavaScript

js
const log = document.getElementById("log");

function pause() {
  document.body.classList.add("paused");
  log.textContent = "FOCUS LOST!";
}

function play() {
  document.body.classList.remove("paused");
  log.textContent =
    "This document has focus. Click outside the document to lose focus.";
}

window.addEventListener("blur", pause);
window.addEventListener("focus", play);

结果

规范

规范
UI 事件
# event-type-focus
HTML
# handler-onfocus

浏览器兼容性

另见

  • 相关事件:blur
  • Element 上的此事件目标:focus 事件