HTMLInputElement: cancel event
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Mai 2023.
Das cancel Ereignis wird auf einem <input> Element ausgelöst, wenn der Benutzer den Dateiauswahldialog über die Esc-Taste oder die Abbrechen-Schaltfläche abbricht und wenn derselbe bereits ausgewählte Datei erneut ausgewählt wird, bei type="file".
Dieses Ereignis kann nicht abgebrochen werden, kann jedoch bubble.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-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 Dateiauswahldialog und schließen Sie dann das Auswahldialogfeld mit der Escape-Taste oder der Abbrechen-Schaltfläche. Beide Aktionen lösen das cancel-Ereignis aus. Versuchen Sie auch, eine lokale Datei auf Ihrem Rechner 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
Siehe auch
- HTML
<input>Element