files/fr/web/api/window/find/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

---
title: Window.find()
slug: Web/API/Window/find
tags:
  - API
  - HTML DOM
  - Méthode
  - NeedsCompatTable
  - NeedsContent
  - Non-standard
  - Reference
  - Window
  - find
translation_of: Web/API/Window/find
---
<div>{{ApiRef}}{{Non-standard_Header}}</div>

<div class="blockIndicator note">
<p><strong>Note:</strong> La prise en charge de <code>Window.find()</code> pourrait changer dans les futures versions de Gecko. Voir {{Bug("672395")}}.</p>
</div>

<p>La méthode <code><strong>Window.find()</strong></code> trouve une chaîne dans une fenêtre.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox"><em>window</em>.find(<em>aString</em>, <em>aCaseSensitive</em>, <em>aBackwards</em>, <em>aWrapAround</em>,
            <em>aWholeWord</em>, <em>aSearchInFrames</em>, <em>aShowDialog</em>);</pre>

<dl>
 <dt><code>aString</code></dt>
 <dd>La chaîne de caractère à rechercher.</dd>
 <dt><code>aCaseSensitive</code></dt>
 <dd>{{jsxref("Boolean")}}. Si <code>true</code>, spécifie une recherche sensible à la casse.</dd>
 <dt><code>aBackwards</code></dt>
 <dd>{{jsxref("Boolean")}}. Si <code>true</code>, spécifie une recherche vers l'arrière.</dd>
 <dt><code>aWrapAround</code></dt>
 <dd>{{jsxref("Boolean")}}. Si <code>true</code>, spécifie une recherche enveloppante.</dd>
 <dt><code>aWholeWord</code> {{Unimplemented_Inline}}</dt>
 <dd>{{jsxref("Boolean")}}. Si <code>true</code>, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir {{bug(481513)}}.</dd>
 <dt><code>aSearchInFrames</code></dt>
 <dd>{{jsxref("Boolean")}}. Si <code>true</code>, spécifie une recherche dans les cadres.</dd>
</dl>

<h3 id="Retourne">Retourne</h3>

<p><code>true</code> si la chaîne est trouvé; autrement, <code>false</code>.</p>

<h2 id="Exemple">Exemple</h2>

<h3 id="JavaScript">JavaScript</h3>

<pre class="brush: js">findString = function findText(text) {
  alert("String \x22" + text + "\x22 found? " + window.find(text));
}</pre>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;p&gt;Apples, Bananas, and Oranges.&lt;/p&gt;
&lt;button type="button" onClick='findString("Apples")'&gt;Search for Apples&lt;/button&gt;
&lt;button type="button" onClick='findString("Banana")'&gt;Search for Banana&lt;/button&gt;
&lt;button type="button" onClick='findString("Orange")'&gt;Search for Orange&lt;/button&gt;
</pre>

<h3 id="Résultat">Résultat</h3>

<p>{{EmbedLiveSample("Example")}}</p>

<h2 id="Notes">Notes</h2>

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

<h2 id="Spécification">Spécification</h2>

<p>Cela ne fait partie d'aucune spécification.</p>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

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