HTMLInputElement: search Event
Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.
Das search
-Ereignis wird ausgelöst, wenn eine Suche mit einem <input>
-Element vom Typ type="search"
gestartet wird.
Es gibt mehrere Möglichkeiten, eine Suche zu initiieren, beispielsweise durch Drücken der Enter-Taste, während das <input>
fokussiert ist, oder, wenn das incremental
Attribut vorhanden ist, nachdem eine von der UA definierte Zeit seit dem letzten Tastendruck abgelaufen ist (wobei neue Tastendrücke die Zeitspanne zurücksetzen, sodass das Auslösen des Ereignisses debounced wird).
Aktuelle Implementierungen von <input type="search">
haben eine zusätzliche Steuerung, um das Feld zu löschen. Die Verwendung dieser Steuerung löst ebenfalls das search
-Ereignis aus. In diesem Fall wird der value
des <input>
-Elements die leere Zeichenkette sein.
Dieses Ereignis kann nicht abgebrochen werden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("search", (event) => {});
onsearch = (event) => {};
Ereignistyp
Ein generisches Event
.
Beispiele
// addEventListener version
const input = document.querySelector('input[type="search"]');
input.addEventListener("search", () => {
console.log(`The term searched for was ${input.value}`);
});
// onsearch version
const input = document.querySelector('input[type="search"]');
input.onsearch = () => {
console.log(`The term searched for was ${input.value}`);
};
Spezifikationen
Dieses Ereignis ist Teil keiner Spezifikation.
Browser-Kompatibilität
BCD tables only load in the browser