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" initiiert wird.

Es gibt mehrere Möglichkeiten, wie eine Suche initiiert werden kann, z.B. durch Drücken der Enter-Taste, während das <input> fokussiert ist, oder, wenn das incremental Attribut vorhanden ist, nach einem vom UA definierten Timeout, das seit der letzten Tastatureingabe abgelaufen ist (wobei neue Tastatureingaben das Timeout zurücksetzen, sodass das Auslösen des Ereignisses entprellt wird).

Aktuelle UA-Implementierungen von <input type="search"> haben eine zusätzliche Steuerung zum Löschen des Feldes. Bei der Verwendung dieser Steuerung wird ebenfalls das search Ereignis ausgelöst. In diesem Fall wird der value des <input> Elements der leere String sein.

Dieses Ereignis ist nicht abbrechbar.

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