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 über ein <input>-Element mit type="search" eine Suche gestartet wird.
Eine Suche kann auf verschiedene Arten gestartet werden, etwa durch Drücken von Enter, während das <input>-Element den Fokus hat. Ist das Attribut incremental vorhanden, kann die Suche auch nach Ablauf einer vom User Agent festgelegten Zeitspanne seit dem letzten Tastendruck gestartet werden. Jeder weitere Tastendruck setzt diese Zeitspanne zurück, sodass das Auslösen des Ereignisses entprellt wird.
Aktuelle Implementierungen von <input type="search"> in User Agents bieten außerdem ein Steuerelement zum Leeren des Felds. Auch bei dessen Verwendung wird das search-Ereignis ausgelöst. In diesem Fall ist der value des <input>-Elements eine leere Zeichenfolge.
Dieses Ereignis kann nicht abgebrochen werden.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("search", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onsearch = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
// addEventListener version
const input = document.querySelector('input[type="search"]');
input.addEventListener("search", () => {
console.log(`The term searched for was ${input.value}`);
});
// onsearch version (but note that this replaces other event listeners
// added using onsearch, if any)
const input = document.querySelector('input[type="search"]');
input.onsearch = () => {
console.log(`The term searched for was ${input.value}`);
};
Spezifikationen
Dieses Ereignis ist nicht Teil einer Spezifikation.