SELFHTML: JavaScript / Objekt-Referenz / frames

SELFHTML/Navigationshilfen

JavaScript/DOM

Objekt-Referenz

frames

frames: Allgemeines zur Verwendung
Auf JavaScripts in anderen Frames zugreifen

Eigenschaft:

length (Anzahl Frames)

Unterobjekte:

document
event
history
location

frames: Allgemeines zur Verwendung

Mit dem Objekt frames haben Sie Zugriff auf Frames, also auf ein Frame-Set und seine Frame-Fenster, die in einer HTML-Datei definiert sind.

Da jedes Frame-Fenster aus Sicht des Browsers ein eigenes Fenster darstellt, ist das frames-Objekt lediglich eine Variante des window-Objekts, also des allgemeinen Fenster-Objekts. Alle Eigenschaften und Methoden, die zum window-Objekt gehören, lassen sich auch auf das frames-Objekt, also auf einzelne Frame-Fenster anwenden. Das frames-Objekt stellt nur deshalb ein eigenes Objekt dar, weil es eine zusätzliche Eigenschaft enthält, und weil bei der Adressierung von Frame-Fenstern in JavaScript ein paar Besonderheiten zu beachten sind:

Schema 1 / Beispiel 1:

parent.frames[#].Eigenschaft/Methode();

parent.frames[1].location.href = "sport.html";

Schema 2 / Beispiel 2:

parent.NameDesFrames.Eigenschaft/Methode();

parent.RechtesFenster.close();

Erläuterung:

parent ist ein reservierter Fenstername, den Sie zum Ansprechen von Fenstern innerhalb eines Frame-Sets verwenden können. Anstelle von parent können Sie auch top verwenden. Mit parent sprechen Sie das Eltern-Fenster des aktuellen Frame-Fensters an, mit top in jedem Fall das oberste Anzeigefenster des Browsers.

Frame-Fenster können Sie auf zwei Arten ansprechen:

mit einer Indexnummer (wie in Schema 1 / Beispiel 1)
Bei Verwendung von Indexnummern geben Sie frames an und dahinter in eckigen Klammern, das wie vielte Frame-Fenster im Frame-Set Sie meinen. Beachten Sie, dass der Zähler bei 0 beginnt, d.h. das erste Frame-Fenster sprechen Sie mit frames[0] an, das zweite Frame-Fenster mit frames[1] usw. Beim Zählen gilt die Reihenfolge, in der die <frame>-Befehle im Frame-Set definiert sind.
mit dem Namen des Frame-Fensters (wie in Schema 2 / Beispiel 2)
Dabei geben Sie den Namen an, der bei der HTML-Definition des Frame-Fenster bei <frame ...> im Attribut name= definiert worden ist.

Da das frames-Objekt eigentlich eine Variante des window-Objekts ist, können Sie nicht nur die alle Eigenschaften und Methoden des window-Objekts auf das frames-Objekt anwenden, sondern auch alle anderen, die in der Hierarchie unterhalb des window-Objekts stehen. Ebenso, wie Sie beispielsweise mit window.document.forms[0].elements[0].value = "Stefan" den Inhalt eines Formular Eingabefelds in einer gewöhnlichen HTML-Datei ändern können, können Sie das gleiche innerhalb eines Frame-Sets etwa mit parent.frames[1].document.forms[0].elements[0].value = "Stefan" erreichen.

Ein typisches Anwendungsbeispiel für den Einsatz des Frame-Objekts finden Sie in diesem Dokument: Zwei Frames gleichzeitig ändern.

Auf JavaScripts in anderen Frames zugreifen

Mit der gleichen Syntax, wie Sie auf HTML-Elemente in anderen Framefenstern zugreifen können, können Sie auch auf JavaScripts zugreifen, die in einem anderen Framefenster aktuell notiert sind. So können Sie Variablen des anderen Scripts auslesen und Funktionen des anderen Scripts aufrufen.

Das folgende Beispiel zeigt ein Frameset mit zwei Fenstern oben und unten. Das obere Fenster hat bei der Frameset-Definition den Namen oberesFenster erhalten. Aus dem unteren Framefenster wird nun auf ein JavaScript im oberen Framefenster zugegriffen

Beispieldatei im oberen Framefenster:

Anzeigebeispiel: So sieht's aus

<html><head><title>Test</title>
<script type="text/javascript">
<!--
var c = 0;

function gibaus_c() {
 alert(c);
}
function erhoehe_c() {
 c++;
 window.setTimeout("erhoehe_c()",100);
}
//-->
</script>
</head><body onLoad="erhoehe_c()">
<p>Hier wird einfach nur 10 mal pro Sekunde die Variable <i>c</i> erh&ouml;ht!</p>
</body></html>

Beispieldatei im unteren Framefenster:

<html><head><title>Test</title>
<script type="text/javascript">
<!--
function reset_c() {
  parent.oberesFenster.c = 0;
}
//-->
</script>
</head><body>
<p>
<a href="javascript:parent.oberesFenster.gibaus_c()">Variable <i>c</i> anzeigen!</a><br>
<a href="javascript:reset_c()">Variable <i>c</i> auf 0 setzen!</a>
</p>
</body></html>

Erläuterung:

Im oberen Fenster ist ein Script mit zwei Funktionen namens gibaus_c() und erhoehe_c() notiert. Die Funktion erhoehe_c() wird mit dem Event-Handler onLoad im einleitenden <body>-Tag erstmals gestartet und ruft sich dann mit Hilfe der Methode setTimeout() alle 100 Millisekunden, also 10 mal pro Sekunde selber wieder auf. Dabei erhöht sie jedesmal die Variable c um 1.

Im unteren Fenster sind zwei Verweise notiert. Der erste gibt den aktuellen Zählerstand von c aus. Dazu wird mit parent.oberesFenster.gibaus_c()" auf die Funktion gibaus_c() im anderen Framefenster zugegriffen. Der zweite Verweis ruft eine Funktion reset_c() auf, die im Dateikopf des eigenen Dokuments notiert ist. Diese greift jedoch mit parent.oberesFenster.c auf die Variable c im anderen Framefenster zu und setzt diese auf 0 zurück.

length

Speichert, wie viele Frame-Fenster ein übergeordnetes Fenster enthält.

Beispiel:

Anzeigebeispiel: So sieht's aus

<html><head><title>Test</title>
<script type="text/javascript">
<!--
for(var i=0; i < parent.frames.length; i++)
 alert(parent.frames[i].name);
//-->
</script>
</head><body>
</body></html>

Erläuterung:

Mit parent.frames.length oder top.frames.length können Sie die Anzahl der Frame-Fenster ermitteln. Im Beispiel wird angenommen, dass die HTML-Datei innerhalb eines Frame-Sets aufgerufen wird. Beim Einlesen der Datei gibt die Datei mit der Methode alert() nacheinander die Namen aller Frame-Fenster im Frame-Set aus. Dazu dient die for-Schleife. Die Eigenschaft parent.frames.length dient als Abbruchbedingung für die Schleife. Da der Schleifenzähler i bei jedem Schleifendurchlauf um 1 erhöht wird, wird mit parent.frames[i] jeweils das nächste Frame-Fenster angesprochen.


	document
	window

SELFHTML/Navigationshilfen

JavaScript/DOM

Objekt-Referenz