Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
HTMLInputElement : évènement search
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
L'évènementsearch de l'interfaceHTMLInputElement est déclenché lorsqu'une recherche est lancée à l'aide d'un élément HTML<input> detype="search".
Il existe plusieurs façons d'initier une recherche, par exemple en appuyant surEntrée lorsque l'élément<input> a le focus, ou, si l'attributincremental est présent, après un délai défini par l'agent utilisateur écoulé depuis la dernière frappe (les nouvelles frappes réinitialisant le délai, de sorte que le déclenchement de l'évènementempêche le rebond).
Les implémentations des agents utilisateurs actuelles de<input type="search"> disposent d'un contrôle supplémentaire pour effacer le champ. L'utilisation de ce contrôle déclenche également l'évènementsearch. Dans ce cas la propriétévalue de l'élément<input> sera la chaîne vide.
Cet évènement n'est pas annulable.
Dans cet article
Syntaxe
Utilisez le nom de l'évènement dans des méthodes commeaddEventListener(), ou affectez un gestionnaire d'évènements à la propriété correspondante.
addEventListener("search", (event) => { })onsearch = (event) => { }Type d'évènement
Un objetEvent générique.
Exemples
// version addEventListenerconst input = document.querySelector('input[type="search"]');input.addEventListener("search", () => { console.log(`Terme recherché : ${input.value}`);});// version onsearchconst input = document.querySelector('input[type="search"]');input.onsearch = () => { console.log(`Terme recherché : ${input.value}`);};Spécifications
Cet évènement ne fait partie d'aucune spécification.