files/fr/web/api/window/frames/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

---
title: Window.frames
slug: Web/API/Window/frames
tags:
  - API
  - DOM
  - DOM Reference
  - DOM_0
  - Gecko
  - NeedsContent
  - NeedsUpdate
  - Property
  - Reference
translation_of: Web/API/Window/frames
---
<p>{{ApiRef("Window")}}</p>

<p> </p>

<h2 id="Summary" name="Summary">Résumé</h2>

<p>Renvoie la fenêtre elle-même, qui est semblable à un objet de type Array, listant les frames présentes dans la fenêtre courante.</p>

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

<pre class="eval"><em>frameList</em> = window.frames;
</pre>

<ul>
 <li><code>frameList</code> est une liste d'objets frame, semblable à un tableau grâce à la propriété <code>length</code> . Ses éléments sont accessibles en utilisant la notation  <code>{{ mediawiki.external('i') }}</code>.</li>
 <li><code>frameList === window</code> est évalué à <code>true</code>.</li>
 <li>Chaque élément de window.frames est un pseudo tableau représentant l'objet <a class="internal" href="/en/DOM/window" title="en/DOM/window">window</a> correspondant au contenu de la  <a class="internal" href="/en/HTML/Element/frame" title="en/HTML/Element/frame">&lt;frame&gt;</a> ou <a class="internal" href="/en/HTML/Element/iframe" title="en/HTML/Element/iframe">&lt;iframe&gt;</a> , et non au DOM element (i)frame (ex., <code>window.frames[ 0 ]</code> équivaut à <code>document.getElementsByTagName( "iframe" )[ 0 ].contentWindow</code>).</li>
 <li>pour plus de détails sur la valeur retournée, se référer au <a class="external external-icon" href="http://groups.google.com/group/mozilla.dev.platform/browse_thread/thread/5628c6f346859d4f/169aa7004565066?hl=en&amp;ie=UTF-8&amp;oe=utf-8&amp;q=window.frames&amp;pli=1" title="http://groups.google.com/group/mozilla.dev.platform/browse_thread/thread/5628c6f346859d4f/169aa7004565066?hl=en&amp;ie=UTF-8&amp;oe=utf-8&amp;q=window.frames&amp;pli=1">fil de discussion sur mozilla.dev.platform</a>.</li>
</ul>

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

<pre class="brush: js">var frames = window.frames; // ou // var frames = window.parent.frames;
for (var i = 0; i &lt; frames.length; i++) {
  // faire quelque chose avec chaque subframe en tant que frames[i]
  frames[i].document.body.style.background = "red";
}
</pre>

<h2 id="Specification" name="Specification">Spécifications</h2>

<p id="comment_text_2">{{SpecName('HTML WHATWG','browsers.html#dom-frames','Window.frames')}}</p>

<p> </p>