Window: frames-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte Eigenschaft frames der Window-Schnittstelle gibt das Fenster selbst zurück. Es handelt sich dabei um ein arrayähnliches Objekt, das die direkten Unter-Frames des aktuellen Fensters auflistet.
Wert
Eine Liste von Frame-Objekten. Sie ähnelt einem Array, da sie eine length-Eigenschaft besitzt und über die [i]-Notation auf ihre Einträge zugegriffen werden kann.
frames === windowergibttrue.- Jeder Eintrag im Pseudo-Array
window.framesist dasWindow-Objekt, das dem Inhalt des jeweiligen<frame>oder<iframe>entspricht, nicht das DOM-Elementframeoderiframeselbst.window.frames[0]ist beispielsweise dasselbe wiedocument.getElementsByTagName("iframe")[0].contentWindow. - Weitere Einzelheiten zum Rückgabewert finden Sie in diesem Thread auf mozilla.dev.platform.
Beispiele
js
const frames = window.frames; // or const frames = window.parent.frames;
for (let i = 0; i < frames.length; i++) {
// do something with each subframe as frames[i]
frames[i].document.body.style.background = "red";
}
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-frames-dev |