| HTML-Dateien selbst erstellen
|  | Dokumentation: JavaScript
|  |  | JavaScript-Objektreferenz

# FENSTERNAME.frames[ ] / FRAMENAME

Allgemeines zur Verwendung
Eigenschaften
Methoden

## Allgemeines zur Verwendung

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

Eine Instanz des Frame-Objekts wird automatisch erzeugt, wenn der WWW-Browser ein Frame-Set anzeigt. Das Frame-Objekt steht in allen Dateien zur Verfügung, die in einem Frame-Fenster des Frame-Sets angezeigt werden.

#### Schema 1 / Beispiel 1:

    parent.frames[#].Eigenschaft/Methode()
    parent.frames[1].location.href = "sport.html"

#### Schema 2 / Beispiel 2:

    parent.FRAMENAME.Eigenschaft/Methode()
    parent.RechtesFenster.location.href = "sport.html"

#### Erläuterung:

parent ist ein reservierter Fenstername, den Sie zum Ansprechen von Fenstern innerhalb eines Frame-Sets verwenden können.

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 wievielte Frame-Fenster im Frame-Set Sie meinen. Beachten Sie, daß 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-Fenster 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 ...> in der Zusatzangabe name= definiert worden ist.

#### Beachten Sie:

Das Frame-Objekt ist eigentlich eine Variante des window-Objekts. Deshalb können Sie nicht nur die im folgenden aufgeführten Eigenschaften und Methoden auf das Frame-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.

## Eigenschaften

parent.frames.length

Lesen

Anzahl der Frames in einem Frame-Set. Wenn Sie in einer Datei, die in einem Frame-Fenster des Frame-Sets angezeigt wird, beispielsweise die Anweisung alert("Dieses Frame-Set enthaelt " + parent.frames.length + " Frame-Fenster") notieren, wird am Bildschirm die Anzahl der Frame-Fenster des Frame-Sets ausgegeben.

parent.frames[`#`].name
parent.FRAMENAME.name

Lesen

Der Name eines Frame-Fensters. Wenn Sie in einer Datei, die in einem von zwei Frame-Fenstern eines Frame-Sets angezeigt wird, beispielsweise die Anweisung alert("Das linke Fenster hat den Namen " + parent.frames[0].name + " und das rechte Fenster den Namen " + parent.frames[1].name) notieren, werden am Bildschirm die Namen der beien Frame-Fenster des Frame-Sets ausgegeben.

## Methoden

parent.frames[`#`].setTimeout(Anweisung,Millisekunden)
parent.FRAMENAME.setTimeout(Anweisung,Millisekunden)
Führt eine beliebige Anweisung, z.B. auch den Aufruf einer Funktion mit anderen Anweisungen, nach so viel Millisekunden aus wie angegeben. Wenn Sie beispielsweise CountDown=parent.Oben.setTimeout("parent.Unten.close()",10000)"> notieren, bewirken Sie, daß Fenster und Datei eines Frames 10 Sekunden lang angezeigt und danach geschlossen werden.

parent.frames[`#`].clearTimeout(TimeoutVariable)
parent.FRAMENAME.clearTimeout(TimeoutVariable)
Macht den Aufruf von setTimeout() rückgängig, sofern dieser in der Form TimeoutVariable = setTimeout() erfolgte, also in einer Variablen gespeichert wurde. Denn diese Variable ist beim Aufruf von clearTimeout() als Parameter zu übergeben.

| Blättern: |
FENSTERNAME.document.links[ ] |  |  | FENSTERNAME.history

| HTML-Dateien selbst erstellen
|  | Dokumentation: JavaScript
|  |  | JavaScript-Objektreferenz