Window : méthode 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 le bogue Firefox 672395 (angl.).
La méthode find() de l'interface Window recherche une chaîne de caractères dans une fenêtre de manière séquentielle.
Syntaxe
find(string, caseSensitive, backwards, wrapAround, wholeWord, searchInFrames, showDialog)
Paramètres
string-
La chaîne de caractères à rechercher.
caseSensitive-
Une valeur booléenne. Si
true, définit une recherche sensible à la casse. backwards-
Une valeur booléenne. Si
true, définit une recherche vers l'arrière. wrapAround-
Une valeur booléenne. Si
true, définit une recherche circulaire. wholeWord-
Une valeur booléenne. Si
true, définit une recherche de mot entier. searchInFrames-
Une valeur booléenne. Si
true, définit une recherche dans les cadres. showDialog-
Une valeur booléenne. Si
true, affiche une boîte de dialogue de recherche.
Valeur de retour
true si la chaîne de caractères est trouvée ; sinon false.
Exemples
HTML
<p>Pommes, Bananes et Oranges.</p>
<button type="button" id="find-apples">Rechercher des Pommes</button>
<button type="button" id="find-bananas">Rechercher des Bananes</button>
<button type="button" id="find-orange">Rechercher des Oranges</button>
<p id="output"></p>
JavaScript
function findString(text) {
document.querySelector("#output").textContent =
`Chaîne de caractères trouvée ? ${window.find(text)}`;
}
document.getElementById("find-apples").addEventListener("click", () => {
findString("Pommes");
});
document.getElementById("find-bananas").addEventListener("click", () => {
findString("Bananes");
});
document.getElementById("find-orange").addEventListener("click", () => {
findString("Oranges");
});
Résultat
Notes
Dans certains navigateurs, Window.find() sélectionne (met en évidence) le contenu trouvé sur le site.
Spécifications
Cela ne fait partie d'aucune spécification.