CloseWatcher: Methode requestClose()

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 vor der Verwendung auf produktiven Webseiten.

Die requestClose()-Methode der CloseWatcher-Schnittstelle löst ein cancel-Ereignis aus und, falls dieses Ereignis nicht mit Event.preventDefault() abgebrochen wird, wird anschließend ein close-Ereignis ausgelöst und der Close-Watcher wird schließlich deaktiviert, als ob destroy() aufgerufen wurde.

Syntax

js
requestClose()

Parameter

Keine.

Rückgabewert

Kein Wert (undefined).

Beispiele

Verwendung der requestClose()-Methode

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

Der onclick-Handler Ihrer UI-Komponente kann requestClose aufrufen, um eine Schließung anzufordern und Ihre Schließanforderung über 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
# dom-closewatcher-requestclose

Browser-Kompatibilität