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 über ein <input>-Element mit type="search" initiiert wird.

Es gibt mehrere Möglichkeiten, eine Suche zu starten, zum Beispiel durch Drücken der Enter-Taste, während das <input> fokussiert ist, oder, falls das incremental-Attribut vorhanden ist, nach einem vom Benutzer-Agent definierten Timeout, das seit dem letzten Tastendruck abgelaufen ist (wobei neue Tastendrücke das Timeout zurücksetzen, sodass das Auslösen des Ereignisses debounced wird).

Aktuelle Implementierungen von <input type="search"> durch Benutzer-Agenten haben ein zusätzliches Steuerelement, um das Feld zu leeren. Auch die Verwendung dieses Steuerelements löst das search Ereignis aus. In diesem Fall wird der value des <input>-Elements der leere String 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