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

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

Syntaxe

js
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

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