34.14 Das Layer-Objekt  
JS 1.2
Ab JavaScript 1.2; nur Netscape.
Hiermit werden HTML-Layer in JavaScript abgebildet; Eigenschaft des document-Objekts.
34.14.1 Allgemeines  
Syntax
|
HTML-Tag: <layer>
document.LayerName
document.layers[Index]
|
Parameter
|
Bedeutung
|
LayerName
|
name-Attribut des Layers
|
Index
|
Nummer des Layers (Zählung ab 0)
|
34.14.2 Event-Handler  
onMouseover onmouseout onfocus onblur onload
34.14.3 Methoden  
load
Erklärung
|
Lädt eine neue URL in den Layer
|
Syntax
|
load(URL, Breite)
|
Parameter
|
Bedeutung
|
URL
|
URL des Layers
|
Breite
|
Breite des Layers
|
moveAbove
Erklärung
|
Bewegt den Layer über einen als Parameter angegebenen Layer, ohne ihn horizontal oder vertikal zu verschieben.
|
Syntax
|
moveAbove(Layer)
|
Parameter
|
Bedeutung
|
Layer
|
Referenz auf den Layer, über den der aktuelle Layer geschoben werden soll
|
moveBelow
Erklärung
|
Bewegt den Layer unter einen als Parameter angegebenen Layer, ohne ihn horizontal oder vertikal zu verschieben.
|
Syntax
|
moveBelow(Layer)
|
Parameter
|
Bedeutung
|
Layer
|
Referenz auf den Layer, unter den der aktuelle Layer geschoben werden soll
|
moveBy
Erklärung
|
Verschiebt einen Layer horizontal und vertikal.
|
Syntax
|
moveBy(hDelta, vDelta)
|
Parameter
|
Bedeutung
|
hDelta
|
relative horizontale Verschiebung
|
vDelta
|
relative vertikale Verschiebung
|
moveTo
Erklärung
|
Verschiebt einen Layer an die angegebene Bildschirmposition.
|
Syntax
|
moveTo(x, y)
|
Parameter
|
Bedeutung
|
x
|
neue x-Koordinate der linken oberen Ecke des Layers
|
y
|
neue y-Koordinate der linken oberen Ecke des Layers
|
moveToAbsolute
Erklärung
|
Verschiebt einen Layer an die angegebene Position auf der Seite.
|
Syntax
|
moveToAbsolute(x, y)
|
Parameter
|
Bedeutung
|
x
|
neue x-Koordinate der linken oberen Ecke des Layers
|
y
|
neue y-Koordinate der linken oberen Ecke des Layers
|
resizeBy
Erklärung
|
Verändert die Ausmaße eines Layers um einen gewissen Wert, wobei die linke obere Ecke fix bleibt.
|
Syntax
|
resizeBy(hDelta, vDelta)
|
Parameter
|
Bedeutung
|
hDelta
|
relative horizontale Veränderung in Pixeln
|
vDelta
|
relative vertikale Veränderung in Pixeln
|
resizeTo
Erklärung
|
Verändert die Ausmaße eines Layers auf einen gewissen Wert, wobei die linke obere Ecke fix bleibt.
|
Syntax
|
resizeTo(Breite, Höhe)
|
Parameter
|
Bedeutung
|
Breite
|
neue Breite des Layers
|
Höhe
|
neue Höhe des Layers
|
34.14.4 Eigenschaften  
above
Erklärung
|
Referenz auf das Layer-Objekt, das vom Z-Index her über dem aktuellen Layer liegt. Ist der aktuelle Layer der oberste, wird eine Referenz auf das aktuelle Fenster zurückgegeben.
|
background
Erklärung
|
Image-Objekt, das die Datei angibt, die als Hintergrundgrafik dient.
|
Beispiel
|
document.layers[0].background.src = "hintergrund.gif"
|
below
Erklärung
|
Referenz auf das Layer-Objekt, das vom Z-Index her unter dem aktuellen Layer liegt. Ist der aktuelle Layer der unterste, wird null zurückgegeben.
|
bgColor
Erklärung
|
Hintergrundfarbe des Layers; entweder mit dem Farbnamen oder dem hexadezimalen RGB-Code festgelegt.
|
clip.bottom
Erklärung
|
Die untere Kante des sichtbaren Bereichs des Layers.
|
clip.height
Erklärung
|
Die Höhe des sichtbaren Bereichs des Layers.
|
clip.left
Erklärung
|
Die linke Kante des sichtbaren Bereichs des Layers.
|
clip.right
Erklärung
|
Die rechte Kante des sichtbaren Bereichs des Layers.
|
clip.top
Erklärung
|
Die obere Kante des sichtbaren Bereichs des Layers.
|
clip.width
Erklärung
|
Die Breite des sichtbaren Bereichs des Layers.
|
document
Erklärung
|
document-Objekt des Layers.
|
left
Erklärung
|
x-Koordinate der linken oberen Ecke des Layers relativ zum übergeordneten Layer.
|
name
Erklärung
|
ID-Attribut des Layers.
|
pageX
Erklärung
|
x-Koordinate der linken oberen Ecke des Layers relativ zur HTML-Seite.
|
pageY
Erklärung
|
y-Koordinate der linken oberen Ecke des Layers relativ zur HTML-Seite.
|
parentLayer
Erklärung
|
Referenz auf den übergeordneten Layer; sollte der nicht existieren, eine Referenz auf das aktuelle Fenster.
|
siblingAbove
Erklärung
|
Von allen Layern mit demselben übergeordneten Layer derjenige, der über dem aktuellen Layer liegt (in Bezug auf den Z-Index); null, falls nicht vorhanden.
|
siblingBelow
Erklärung
|
Von allen Layern mit demselben übergeordneten Layer derjenige, der unter dem aktuellen Layer liegt (in Bezug auf den Z-Index); null, falls nicht vorhanden.
|
src
Erklärung
|
URL des Layers.
|
top
Erklärung
|
y-Koordinate der linken oberen Ecke des Layers relativ zum übergeordneten Layer.
|
visibility
Erklärung
|
Gibt an, ob der Layer sichtbar ist. Bei "visible" oder "show" wird der Layer angezeigt, bei "hide" wird er versteckt, bei "inherit" wird die visibility-Eigenschaft des übergeordneten Layers verwendet.
|
Beispiel
|
<a href="javascript:document.layers[0].visibility=
'hide';">Layer verstecken</a>
|
window
Erklärung
|
Referenz auf das Fenster oder den Frame, das bzw. der den Layer enthält.
|
x
Erklärung
|
Äquivalent zu Layer.left.
|
y
Erklärung
|
Äquivalent zu Layer.top.
|
zIndex
Erklärung
|
Z-Index des Layers.
|
|