Document: selectionchange Ereignis

Baseline Widely available

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

Das selectionchange Ereignis der Selection API wird ausgelöst, wenn die aktuelle Selection eines Document geändert wird.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.

Das Ereignis kann durch Hinzufügen eines Event-Listeners für selectionchange oder durch die Verwendung des onselectionchange Ereignishandlers behandelt werden.

Hinweis: Dieses Ereignis ist nicht dasselbe wie die selectionchange Ereignisse, die ausgelöst werden, wenn die Textauswahl in einem <input> oder <textarea> Element geändert wird. Weitere Informationen finden Sie im selectionchange Ereignis des HTMLInputElement.

Syntax

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

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

onselectionchange = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

js
// addEventListener version
document.addEventListener("selectionchange", () => {
  console.log(document.getSelection());
});

// onselectionchange version
document.onselectionchange = () => {
  console.log(document.getSelection());
};

Spezifikationen

Specification
Selection API
# selectionchange-event
Selection API
# dom-globaleventhandlers-onselectionchange

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch