HTMLInputElement: search event

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

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