Window.find()

Non standard

Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Note: La prise en charge de Window.find() pourrait changer dans les futures versions de Gecko. Voir bug 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 Non implémenté: Boolean. Si true, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir bug 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

<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.