aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/window/find/index.md
blob: ee36dd5c172ceada7ba8afb39021ccf69123e67d (plain)
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
---
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
---
{{ApiRef}}{{Non-standard_Header}}

> **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`
  - : {{jsxref("Boolean")}}. Si `true`, spécifie une recherche sensible à la casse.
- `aBackwards`
  - : {{jsxref("Boolean")}}. Si `true`, spécifie une recherche vers l'arrière.
- `aWrapAround`
  - : {{jsxref("Boolean")}}. Si `true`, spécifie une recherche enveloppante.
- `aWholeWord` {{Unimplemented_Inline}}
  - : {{jsxref("Boolean")}}. Si `true`, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir {{bug(481513)}}.
- `aSearchInFrames`
  - : {{jsxref("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

{{EmbedLiveSample("Exemple")}}

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