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 Widely available

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

Specification
HTML
# dom-frames-dev

Compatibilité des navigateurs