Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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ènement search de l'interface HTMLInputElement est déclenché lorsqu'une recherche est lancée à l'aide d'un élément HTML <input> de type="search".

Il existe plusieurs façons d'initier une recherche, par exemple en appuyant sur Entrée lorsque l'élément <input> a le focus, ou, si l'attribut incremental 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ènement empê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ènement search. Dans ce cas la propriété value de l'élément <input> sera la chaîne vide.

Cet évènement n'est pas annulable.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou affectez un gestionnaire d'évènements à la propriété correspondante.

js
addEventListener("search", (event) => { })

onsearch = (event) => { }

Type d'évènement

Un objet Event générique.

Exemples

js
// version addEventListener
const input = document.querySelector('input[type="search"]');

input.addEventListener("search", () => {
  console.log(`Terme recherché : ${input.value}`);
});
js
// version onsearch
const 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.

Compatibilité des navigateurs