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.