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.

In diesem Artikel

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

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

HTML DOM API
HTMLInputElement
Instanzeigenschaften
Instanzmethoden
Events
Vererbung
Verwandte Seiten für HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung