Window.find()

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.

Note : La prise en charge de Window.find() pourrait changer dans les futures versions de Gecko. Voir bug Firefox 672395.

La méthode Window.find() trouve une chaîne dans une fenêtre.

Syntaxe

window.find(
  aString,
  aCaseSensitive,
  aBackwards,
  aWrapAround,
  aWholeWord,
  aSearchInFrames,
  aShowDialog,
);

aString: La chaîne de caractère à rechercher.
aCaseSensitive: Boolean. Si true, spécifie une recherche sensible à la casse.
aBackwards: Boolean. Si true, spécifie une recherche vers l'arrière.
aWrapAround: Boolean. Si true, spécifie une recherche enveloppante.
aWholeWord: Boolean. Si true, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir bug Firefox 481513.
aSearchInFrames: Boolean. Si true, spécifie une recherche dans les cadres.

Retourne

true si la chaîne est trouvé; autrement, false.

Exemple

JavaScript

findString = function findText(text) {
  alert("String \x22" + text + "\x22 found? " + window.find(text));
};

HTML

html

<p>Apples, Bananas, and Oranges.</p>
<button type="button" onClick='findString("Apples")'>Search for Apples</button>
<button type="button" onClick='findString("Banana")'>Search for Banana</button>
<button type="button" onClick='findString("Orange")'>Search for Orange</button>

Résultat

Notes

Dans certains navigateurs, Window.find() sélectionne (met en évidence) le contenu trouvé sur le site.

Spécification

Cela ne fait partie d'aucune spécification.

Compatibilité des navigateurs

Cette méthode fonctionne dans de nombreux navigateurs modernes, notamment Firefox, Chrome, et Safari.