HTMLInputElement: cancel Ereignis
Baseline
2023
Newly available
Since May 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Das cancel Ereignis wird auf einem <input> Element ausgelöst, wenn der Benutzer den Dateiauswahldialog über die Esc-Taste oder die Abbrechen-Taste abbricht und wenn der Benutzer dieselben Dateien erneut auswählt, die vorher bei type="file" ausgewählt wurden.
Dieses Ereignis kann nicht abgebrochen werden, kann aber propagieren.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("cancel", (event) => { })
oncancel = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
Abbrechen eines Eingabeelements
HTML
<label for="file">Select a file. Or don't.</label>
<input type="file" id="file" name="file" />
<div id="result"></div>
JavaScript
const elem = document.getElementById("file");
const result = document.getElementById("result");
elem.addEventListener("cancel", () => {
result.textContent = "Canceled.";
});
elem.addEventListener("change", () => {
if (elem.files.length === 1) {
result.textContent = "File Selected.";
}
});
Ergebnis
Öffnen Sie den Dateiauswähler und schließen Sie dann das Auswahldialogfenster mit der Esc-Taste oder der Abbrechen-Taste. Beide Vorgänge lösen das cancel Ereignis aus. Versuchen Sie auch, eine lokale Datei auf Ihrem Computer auszuwählen; öffnen Sie dann das Dateiauswahlfenster erneut und wählen Sie dieselbe Datei erneut aus. Auch dies löst das cancel Ereignis aus.
Spezifikationen
| Specification |
|---|
| HTML # event-cancel |
| HTML # handler-oncancel |
Browser-Kompatibilität
Loading…
Siehe auch
- HTML
<input>Element