Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Window : propriété frames

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

>

La propriété frames de l'interface Window retourne la fenêtre elle-même, qui est semblable à un objet de type tableau (array), listant les sous-cadres directs de la fenêtre courante.

Valeur

Une liste d'objets de cadre. Elle est similaire à un tableau en ce qu'elle possède une propriété length et que ses éléments peuvent être accessibles en utilisant la notation [i].

  • frames === window est évalué comme vrai.
  • Chaque élément du pseudo-tableau window.frames représente l'objet Window correspondant au contenu du <frame> ou du <iframe> donné, et non à l'élément DOM frame ou iframe (c'est-à-dire, window.frames[0] est la même chose que document.getElementsByTagName("iframe")[0].contentWindow).
  • Pour plus de détails sur la valeur retournée, consultez ce fil de discussion sur mozilla.dev.platform (angl.).

Exemples

js
const frames = window.frames; // ou const frames = window.parent.frames;
for (let i = 0; i < frames.length; i++) {
  // faire quelque chose avec chaque sous-cadre en tant que frames[i]
  frames[i].document.body.style.background = "red";
}

Spécifications

Spécification
HTML>
# dom-frames-dev>

Compatibilité des navigateurs