Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Fenster: blur-Ereignis

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Das blur-Ereignis wird ausgelöst, wenn ein Element den Fokus verloren hat.

Das Gegenteil von blur ist focus.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht gebubbelt.

Syntax

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

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

onblur = (event) => { }

Ereignistyp

Ein FocusEvent. Erbt von UIEvent und Event.

Event UIEvent FocusEvent

Ereigniseigenschaften

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

FocusEvent.relatedTarget

Ein EventTarget, das ein sekundäres Ziel für dieses Ereignis darstellt. In einigen Fällen (z.B. beim Tabben in oder aus einer Seite) 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: #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);

Ergebnis

Spezifikationen

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

Browser-Kompatibilität

Der Wert von Document.activeElement variiert in verschiedenen Browsern, während dieses Ereignis behandelt wird (Firefox bug 452307): IE10 setzt es auf das Element, zu dem der Fokus wechseln wird, während Firefox und Chrome es oft auf den body des Dokuments setzen.

Siehe auch

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