Window: blur Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das blur Ereignis wird ausgelöst, wenn ein Element den Fokus verliert.

Das Gegenteil von blur ist focus.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

onblur = (event) => {};

Ereignistyp

Ereignis-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihrem übergeordneten UIEvent und indirekt von Event.

FocusEvent.relatedTarget

Ein EventTarget, das ein sekundäres Ziel für dieses Ereignis darstellt. In einigen Fällen (wie beim Wechseln der Seitenansicht) kann diese Eigenschaft aus Sicherheitsgründen auf null gesetzt werden.

Beispiele

Live-Beispiel

Dieses Beispiel ändert das Erscheinungsbild eines Dokuments, wenn es den Fokus verliert. Es verwendet addEventListener(), um focus und blur Ereignisse zu überwachen.

HTML

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

CSS

css
.paused {
  background: #ddd;
  color: #555;
}

JavaScript

js
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.";
}

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

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

Ergebnis

Spezifikationen

Specification
UI Events
# event-type-blur
HTML
# handler-onblur

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
blur event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Der Wert von Document.activeElement variiert zwischen Browsern, während dieses Ereignis gehandhabt wird (Firefox-Bug 452307): IE10 setzt es auf das Element, zu dem der Fokus wechselt, während Firefox und Chrome es häufig auf den body des Dokuments setzen.

Siehe auch

  • Verwandtes Ereignis: focus
  • Dieses Ereignis auf Element-Zielen: blur Ereignis