此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Window:blur 事件

基线
广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

blur 事件在窗口失去焦点(例如用户将焦点从页面移至地址栏)时触发。在此之前,焦点可能位于文档的视口或其中的某个元素上。

与 blur 相反的是 focus。

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

语法

在 addEventListener() 等方法中使用事件名称,或设置事件处理器属性。

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

onblur = (event) => { }

事件类型

FocusEvent。继承自 UIEvent 和 Event。

Event UIEvent FocusEvent

示例

实时示例

本示例在文档失去焦点时更改其外观。它使用 addEventListener() 监听 focus 和 blur 事件。

HTML

html
<p id="log">点击此文档使其获得焦点。</p>

CSS

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

JavaScript

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

function pause() {
  document.body.classList.add("paused");
  log.textContent = "失去焦点!";
}

function play() {
  document.body.classList.remove("paused");
  log.textContent = "此文档拥有焦点。点击文档外部可失去焦点。";
}

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

结果

规范

规范
UI Events
# event-type-blur
HTML
# handler-onblur

浏览器兼容性

参见

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