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.

js
addEventListener("search", (event) => {});

onsearch = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

js
// addEventListener version
const input = document.querySelector('input[type="search"]');

input.addEventListener("search", () => {
  console.log(`The term searched for was ${input.value}`);
});
js
// 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