Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HTMLInputElement: search Ereignis

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, eine Suche zu starten, zum Beispiel durch Drücken der Enter-Taste, während das <input>-Element fokussiert ist. Wenn das incremental-Attribut vorhanden ist, wird das Ereignis nach einem vom UA definierten Timeout seit der letzten Tastenanschlages ausgelöst (wobei neue Tastenanschläge den Timeout zurücksetzen, sodass das Ereignis entprellt wird).

Aktuelle UA-Implementierungen von <input type="search"> haben eine zusätzliche Steuerung, um das Feld zu leeren. Die Verwendung dieses Steuerungselements löst ebenfalls das search-Ereignis aus. In diesem Fall ist der value des <input>-Elements der leere String.

Dieses Ereignis kann nicht abgebrochen werden.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-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