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
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
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
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
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
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
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
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.
© 1997 Stefan Münz, s.muenz@euromail.com