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

# FENSTERNAME.document.layers[ ] / LAYERNAME

Allgemeines zur Verwendung
Eigenschaften
Methoden

## Allgemeines zur Verwendung

Mit dem Objekt FENSTERNAME.document.layers[ ] / LAYERNAME haben Sie Zugriff auf alle Layer, die in einer HTML-Datei definiert sind. Layer und die hier behandelten JavaScript-Elemente werden derzeit nur von Netscape ab Version 4.0 interpretiert.

Eine Objektinstanz des Layer-Objekts wird automatisch erzeugt, wenn der WWW-Browser mindestens einen Layer in der HTML-Datei vorfindet.

### Layer ansprechen

Sie können definierte Layer mit JavaScript ansprechen.

#### Schema 1 / Beispiel 1:

    FENSTERNAME.document.layers[#].Eigenschaft/Methode()
    window.document.layers[1].moveTo(100,200);

#### Schema 2 / Beispiel 2:

    FENSTERNAME.document.LAYERNAME.Eigenschaft/Methode()
    window.document.Zweitlayer.moveTo(100,200);

#### Erläuterung:

Die Layer einer HTML-Datei können Sie auf zwei Arten ansprechen:

- mit einer Indexnummer (wie in Schema 1 / Beispiel 1)
  Bei Verwendung von Indexnummern geben Sie layers an und dahinter in eckigen Klammern, den wievielten Layer innerhalb der HTML-Datei Sie meinen. Beachten Sie, daß der Zähler bei 0 beginnt, d.h. den ersten Layer sprechen Sie mit layers[0] an, den zweiten Layer mit layers[1] usw. Beim Zählen gilt die Reihenfolge, in der die Layer in der HTML-Datei eingebunden sind.

- mit dem Namen des Layers (wie in Schema 2 / Beispiel 2)
  Dabei geben Sie den Namen an, der beim Definieren des Layers in der Zusatzangabe name= definiert worden ist.

#### Beachten Sie:

Die hier beschriebenen JavaScript-Elemente gelten vorerst nur für Fest positionierte Layer.

Zu den Fensternamen lesen Sie den Abschnitt Allgemeines zur Verwendung des window-Objekts. Bei Verwendung von Frames lesen Sie auch den Abschnitt Allgemeines zur Verwendung des Frame-Objekts.

## Eigenschaften

FENSTERNAME.document.layers[`#`].clip.left/top/right/bottom/width/height
FENSTERNAME.document.LAYERNAME.clip.left/top/right/bottom/width/height

Lesen | Ändern

Ein Rechteck zum Beschneiden des Anzeigebereichs von Layern. Mit zwei Anweisungen wie window.document.layers[0].clip.left=50; window.document.layers[0].clip.top=30; können Sie beispielsweise die linke obere Ecke des beschneidenden Rechtecks für den ersten Layer in der Datei ändern.

FENSTERNAME.document.layers[`#`].left
FENSTERNAME.document.LAYERNAME.left

Lesen | Ändern

Innerhalb der Definition der linken oberen Ecke eines Layers der Wert für "links". Mit zwei Anweisungen wie window.document.KleinerLayer.left=80; window.document.KleinerLayer.top=40; können Sie beispielsweise den kompletten Layer mit dem Namen "KleinerLayer" an eine andere Stelle verschieben.

FENSTERNAME.document.layers[`#`].name
FENSTERNAME.document.LAYERNAME.name

Lesen

Der Name eines Layers, sofern ein Name vergeben wurde. Mit einer Anweisung wie var L1Name = window.document.layers[3].name; können Sie beispielsweise den Namen des vierten in der Datei definierten Layers in einer Variable speichern. Die Variable können Sie dann weiterverarbeiten.

FENSTERNAME.document.layers[`#`].siblingAbove
FENSTERNAME.document.LAYERNAME.siblingAbove

Lesen

Der Layer, der aufgrund der numerischen Ordnung, die mit z-index= festgelegt wurde, über dem angesprochenen Layer liegt. Es handelt sich dabei um ein Layer-Objekt, für das seinerseits alle verfügbaren Eigenschaften und Methoden gelten. So können Sie beispielsweise mit var x = window.document.GrosserLayer.siblingAbove.name den Namen des Layers in einer Variablen speichern, der sich in der Reihenfolge über dem angesprochenen Layer, also im Beispiel unter dem Layer mit dem Namen "GrosserLayer" befindet.

FENSTERNAME.document.layers[`#`].siblingBelow
FENSTERNAME.document.LAYERNAME.siblingBelow

Lesen

Der Layer, der aufgrund der numerischen Ordnung, die mit z-index= festgelegt wurde, unter dem angesprochenen Layer liegt. Analog zu ...siblingAbove.

FENSTERNAME.document.layers[`#`].top
FENSTERNAME.document.LAYERNAME.top

Lesen | Ändern

Innerhalb der Definition der linken oberen Ecke eines Layers der Wert für "oben". Mit zwei Anweisungen wie window.document.KleinerLayer.left=80; window.document.KleinerLayer.top=40; können Sie beispielsweise den kompletten Layer mit dem Namen "KleinerLayer" an eine andere Stelle verschieben.

FENSTERNAME.document.layers[`#`].visibility
FENSTERNAME.document.LAYERNAME.visibility

Lesen | Ändern

Angabe zum Anzeigen oder Verstecken eines Layers. Mögliche Werte sind "show" (anzeigen), "hide"(verstecken) oder "inherit" (wie Eltern-Layer). Wenn ein Layer beispielsweise in der HTML-Datei zunächst auf "show" eingestellt ist, können Sie ihn mit einer Anweisung wie FENSTERNAME.document.layers[0].visibility="hide" verstecken.

## Methoden

FENSTERNAME.document.layers.[`#`].moveAbove(Layername)
FENSTERNAME.document.LAYERNAME.moveAbove(Layername)
Legt den angesprochenen Layer über den mit "Layername" benannten Layer.

FENSTERNAME.document.layers.[`#`].moveBelow(Layername)
FENSTERNAME.document.LAYERNAME.moveBelow(Layername)
Legt den angesprochenen Layer unter den mit "Layername" benannten Layer.

FENSTERNAME.document.layers.[`#`].moveTo(x,y)
FENSTERNAME.document.LAYERNAME.moveTo(x,y)
Verschiebt den angesprochenen Layer so, daß die neue left-Position (=links) bei x beginnt und die neue top-Position (=oben) bei y.

FENSTERNAME.document.layers.[`#`].offset(x,y)
FENSTERNAME.document.LAYERNAME.offset(x,y)
Verschiebt den angesprochenen Layer so, daß die neue left-Position (=links) x Pixel weiter oder weniger links beginnt als zuvor und die neue top-Position (=oben) y Pixel weiter unten oder oben als zuvor. Für Verschiebung nach links bzw. oben müssen Sie negative Werte benutzen.

FENSTERNAME.document.layers.[`#`].resize(rechts,unten)
FENSTERNAME.document.LAYERNAME.resize(Breite,Höhe)
Verändert die Größe eines Rechtecks zum Beschneiden des Anzeigebereichs von Layern. Mit rechts bzw. unten geben Sie die Pixelkoordinaten der neuen gewünschten rechten unteren Ecke an.

| Blättern: |
FENSTERNAME.document.images[ ] / BILDNAME |  |  | FENSTERNAME.document.links[ ]

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