CloseWatcher: requestClose()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die requestClose()-Methode der CloseWatcher-Schnittstelle löst ein cancel-Ereignis aus. Wenn dieses Ereignis nicht mit Event.preventDefault() abgebrochen wird, fährt die Methode fort, ein close-Ereignis auszulösen, und deaktiviert schließlich den Close Watcher, als ob destroy() aufgerufen wurde.

Syntax

js
requestClose()

Parameter

Keine.

Rückgabewert

Keine (undefined).

Beispiele

Verwendung der requestClose()-Methode

In diesem Beispiel haben Sie eine eigene UI-Komponente (einen Picker), und Sie möchten sowohl die Standard-Schließmethode der Plattform (z. B. die Esc-Taste) als auch Ihre benutzerdefinierte Schließmethode (eine Schaltfläche zum Schließen) unterstützen.

Der onclick-Handler Ihrer UI-Komponente kann requestClose aufrufen, um eine Schließung anzufordern und Ihre Schließanforderung durch denselben onclose-Handler zu leiten, den die Schließmethode der Plattform verwendet.

js
const watcher = new CloseWatcher();
const picker = setUpAndShowPickerDOMElement();
let chosenValue = null;

watcher.onclose = () => {
  chosenValue = picker.querySelector("input").value;
  picker.remove();
};

picker.querySelector(".close-button").onclick = () => watcher.requestClose();

Spezifikationen

Specification
HTML Standard
# dom-closewatcher-requestclose

Browser-Kompatibilität

BCD tables only load in the browser