body | NN 6 IE 4 DOM 1 | ||||||||||||||||||||||||||||||||||
Das body-Objekt spiegelt das body-Element wider, das sich vom document-Objekt unterscheidet. Das body-Objekt bezieht sich nur auf das Element und den darin verschachtelten Inhalt. Da eine HTML-Seite immer nur ein Body-Element enthalten kann, lässt sich dieses Objekt sowohl in IE- als auch im W3C-DOM in der Kurzform document.body referenzieren. Die hier aufgeführten Ereignisbehandlungsroutinen erscheinen als Attribute im <body>-Tag, sind in Wirklichkeit jedoch Ereignisse auf Dokumentebene (und werden am besten als Eigenschaft in der Form document.eventName referenziert). Während in IE für den Mac die Client- und Bildlaufeigenschaften nicht bei allen Elementobjekten verwendet werden können, sind diese Eigenschaften für das body-Objekt definiert. |
|||||||||||||||||||||||||||||||||||
Mit den Bemühungen, den standardkompatiblen Modus in IE 6 für Windows einzuführen (siehe Ausführungen zum DOCTYPE-Element in Kapitel 8), hat Microsoft dafür gesorgt, dass der alten Trick, mithilfe der Eigenschaften clientHeight und clientWidth des body-Elements die den Netscape-Eigenschaften windows.innerHeight und windows.innerWidth entsprechenden Eigenschaften abzurufen, nicht mehr funktioniert. Im Standardkompatibilitätsmodus (in dem document.compatMode == "CSS1Compat") müssen Sie daher die Eigenschaften clientHeight und clientWidth des html-Elements verwenden, um diese Werte aufzufinden. Verwenden Sie die folgenden effektiven Referenzkurzformen: document.body.parentNode.clientHeight document.body.parentNode.clientWidth |
|||||||||||||||||||||||||||||||||||
HTML-Äquivalent | |||||||||||||||||||||||||||||||||||
<body> |
|||||||||||||||||||||||||||||||||||
Objektmodellreferenz | |||||||||||||||||||||||||||||||||||
[window.]document.body |
|||||||||||||||||||||||||||||||||||
Objektspezifische Eigenschaften | |||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||
Objektspezifische Methoden | |||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | |||||||||||||||||||||||||||||||||||
|
accessKey | NN nicht zutreffend IE 4 DOM 1 |
Lesen/Schreiben | |
Dies ist eine einzelne Buchstabentaste, durch die ein Element (in manchen Browsern) den Fokus erhält oder ein Formularsteuerelement bzw. eine Link-Aktion aktiviert wird. Der Browser und das Betriebssystem bestimmen, ob zusammen mit der Buchstabentaste eine Zusatztaste (wie Strg, Alt oder Befehl) gedrückt werden muss, damit der Link aktiviert wird. In IE für Windows ab Version 5 und Netscape 6 muss gleichzeitig die Alt-Taste gedrückt werden, und bei der Buchstabentaste wird nicht zwischen Groß- und Kleinschreibung unterschieden. In IE für den Macintosh ab Version 5 und der Macintosh-Version von Netscape 6 funktioniert die Zugriffstaste nur in Verbindung mit der Ctrl-Taste. |
|
Obwohl sie hier als gemeinsame Eigenschaft aufgeführt, wird sie streng genommen nicht in allen Implementierungen unterstützt. Netscape 6 (per W3C-DOM) erkennt diese Eigenschaft nur in Verbindung mit den folgenden Elementen: a, area, button, input, label, legend und textarea, IE 4 darüber hinaus für applet, body, div, embed, isindex, marquee, object, select, span, table und td (nicht jedoch für label und legend). IE 5 erkennt dieses Attribut in Verbindung mit allen darstellbaren Elementen, weist in diesem Zusammenhang jedoch eine Besonderheit auf: Außer bei input und anderen formularbezogenen Elementen müssen Sie einem Element für IE ab Version 5 außerdem ein tabindex-Attribut mit einem beliebigen Wert oder einen beliebigen tabIndex-Eigenschaftswert zuweisen, damit der Benutzer in der Lage ist, ihm mithilfe der Schnellzugriffstaste den Fokus zu übergeben. In Netscape 7 hat eine Änderung des Eigenschaftswerts in einem Skript bisher keine Auswirkung auf das Verhalten der Benutzeroberfläche. |
|
Beispiel | |
document.links[3].accessKey = "n"; |
|
Wert | |
Einzelnes alphanumerisches Zeichen (oder ein Satzzeichen). |
|
Standardwert | |
Leere Zeichenfolge. |
aLink | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt die Farbe eines Hypertext-Links an, wenn er angeklickt wird. Die Farbe wird auf den Hyperlink-Text oder auf den Rahmen eines Bildes oder Objekts angewendet, das in einem a-Element eingebettet ist. Weitere Informationen zu den Farben für besuchte und nicht besuchte Hyperlinks finden Sie unter den Eigenschaften link und vLink. Die veraltete aber rückwärtskompatible Version dieser Eigenschaft ist die alinkColor-Eigenschaft des document-Objekts. |
|
Beispiel | |
document.body.aLink = "green"; |
|
Wert | |
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A. |
|
Standardwert | |
#0000FF |
background | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Stellt die URL des Hintergrundbildes für das gesamte Dokument bereit. Wurde ebenfalls eine bgColor (Hintergrundfarbe) für das Element festgelegt, wird diese Farbe angewendet, wenn das Bild nicht geladen werden konnte; andernfalls überlagert das Bild die Farbe. |
|
Beispiel | |
document.body.background = "images/watermark.jpg"; |
|
Wert | |
Eine vollständige oder relative URL einer Hintergrund-Bilddatei. |
|
Standardwert | |
Keiner. |
bgColor | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt die Hintergrundfarbe des Elements an. Auch wenn das bgcolor-Attribut oder die bgColor-Eigenschaft mit einem unverschlüsselten Farbnamen definiert wurde, ist der zurückgegebene Wert immer ein hexadezimales Triplett. |
|
Beispiel | |
document.body.bgColor = "yellow"; |
|
Wert | |
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A. |
|
Standardwert | |
Hängt vom Browser und dem Betriebssystem ab. |
bgProperties | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Legt fest, ob das Hintergrundbild an einer festen Position bleibt oder ob es sich mitbewegt, wenn der Benutzer einen Bildlauf auf der Seite durchführt. Wurde das Hintergrundbild so definiert, dass es an einer festen Position verbleibt, rollt der Inhalt etwa so über das Hintergrundbild wie in einem Film, bei dem der Abspann über das Hintergrundbild läuft. |
|
Beispiel | |
document.body.bgProperties = "fixed"; |
|
Wert | |
Eine leere Zeichenfolge (normales Bildlaufverhalten) oder die Konstantenzeichenfolge fixed, bei der nicht zwischen Groß- und Kleinschreibung unterschieden wird. |
|
Standardwert | |
Leere Zeichenfolge. |
bottomMargin | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt den Leerraum zwischen der Unterkante des Inhalts und dem unteren Rand einer rollbaren Seite an. Diese Einstellung hat keine sichtbaren Auswirkungen, wenn die Länge des Inhalts oder die Größe des Fensters nicht zu einem Bildlauf im Fenster führt. Standardmäßig schließt der Inhalt mit dem Ende des Dokuments ab; in der Macintosh-Version von Internet Explorer gibt es allerdings selbst beim Wert Null noch einen ca. 10 Pixel breiten Rand. Größere Werte werden korrekt wiedergegeben. Diese Eigenschaft stellt in gewissem Sinne eine verkürzte oder alternative Form zur Definition der Stylesheet-Eigenschaft marginBottom für das body-Elementobjekt dar. |
|
Beispiel | |
document.body.bottomMargin = 20; |
|
Wert | |
Ein ganzzahliger Pixelwert (größer oder gleich Null) für den Leerraum am unteren Rand des Dokuments. |
|
Standardwert | |
0 |
filters[ ] | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Gibt ein Array aller filter-Objekte zurück, die im aktuellen Dokument enthalten sind. Gilt nur für die folgenden Elementobjekte: bdo, body, button, div, fieldset, img, input, marquee, rt, ruby, span, table, td, textarea und th. Informationen zur Referenzierungssyntax finden Sie in der Abhandlung des filter-Objekts. |
|
Wert | |
Array mit filter-Objektreferenzen. |
|
Standardwert | |
Array mit einer Länge von Null. |
isTextEdit | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Legt fest, ob das Element verwendet werden kann, um mithilfe der Methode createTextRange( ) ein TextRange-Objekt für IE/Windows zu erstellen. Das Erstellen von Textbereichen für Inhalte ist nur bei body-, button-, Text-input- und textarea-Elementen zulässig. |
|
Beispiel | |
if (document.getElementById("elementID").isTextEdit) { var rng = document.getElementById("elementID").createTextRange( ); } |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
Standardeinstellung des Elements. |
leftMargin | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt die Breite des linken Rands des body-Elements im Browserfenster oder Frame in Pixel an. Standardmäßig fügt der Browser einen schmalen Rand ein, damit der Inhalt nicht an den linke Rand des Fensters anstößt. Die Angabe einer leeren Zeichenfolge für diese Eigenschaft hat die gleiche Wirkung wie der Wert 0. |
|
Beispiel | |
document.body.leftMargin = 16; |
|
Wert | |
Ein ganzzahliger Pixelwert. |
|
Standardwert | |
10 (Windows); 8 (Macintosh). |
clientLeft, clientTop | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Geben die linke und obere Koordinate des Elementinhalts innerhalb des Rechtecks bereit, das die Elementauffüllung enthält, jedoch mit geringfügigen Abweichungen bei den verschiedenen Betriebssystemversionen von IE. In IE für Macintosh nicht für alle Elementtypen verfügbar. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels. Hilfreichere Informationen zur Positionierung von Inline-Elementen lassen sich im Allgemeinen über die Eigenschaften offsetLeft und offsetTop ermitteln (einschließlich Netscape 6). Bei CSS-positionierten Elementen verwenden Sie style-Objekteigenschaften wie left und top sowie (nur in IE) pixelLeft und pixelTop (auch zum Ändern der Position eines Elements). |
|
Wert | |
Ein Pixelwert als ganze Zahl. |
|
Standardwert | |
0 |
clientHeight, clientWidth | NN 7 IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Geben die Höhe und Breite des Elementinhalts zurück, jedoch mit geringfügigen Abweichungen hinsichtlich der Elementauffüllung bei den verschiedenen Betriebssystemversionen von IE und den verschiedenen von der DOCTYPE-Deklaration gesteuerten Kompatibilitätsmodi. In IE für Macintosh nicht für alle Elementtypen verfügbar. Bei Netscape 7 sind die Werte Null, es sei denn, der Inhalt eines Elements ragt über den sichtbaren Bereich hinaus, in welchem Fall die Werte die Abmessungen des sichtbaren Bereichs (beim Element document.body beispielsweise den Inhaltsbereich des Browserfensters) angeben. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels. |
|
Beispiel | |
var midHeight = document.body.clientHeight/2; |
|
Wert | |
Ein Pixelwert als ganze Zahl. |
|
Standardwert | |
0 |
link | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt die Farbe eines Hypertext-Links an, der noch nicht besucht wurde (d. h. die URL des Hyperlinks befindet sich nicht im Cache des Browsers). Für einen Link sind drei Zustände möglich: nicht besucht, aktiv und besucht. Die Farbe wird auf den Hyperlink-Text oder auf den Rahmen eines Bildes oder Objekts angewendet, das in einem a-Element eingebettet ist. Diese Eigenschaft hat die gleichen Auswirkungen wie das Einstellen der linkColor-Eigenschaft eines document-Objekts. |
|
Beispiel | |
document.body.link = "#00FF00"; |
|
Wert | |
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A. |
|
Standardwert | |
#0000FF |
noWrap | NN nicht zutreffend IE 4 DOM 1 |
Lesen/Schreiben | |
Legt fest, ob der Browser den Textinhalt so breit darstellt, wie es notwendig ist, damit eine Zeile, die nicht umbrochen werden soll, in eine einzige Zeile passt. Eine falsche Einstellung für dieses Attribut kann dazu führen, dass ein großer horizontaler Bildlauf durchgeführt werden muss, um den gesamten Inhalt anzuzeigen. |
|
Beispiel | |
document.body.noWrap = "true"; |
|
Wert | |
Boolescher Wert: true | false. |
|
Standardwert | |
false |
recordNumber | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Wird zur Datenbindung in IE verwendet und gibt eine ganze Zahl zurück, die den Datensatz in der Datenmenge repräsentiert, die das Element erzeugte (d. h. ein Element, dessen Inhalt über die Datenbindung eingefügt wird). Werte für diese Eigenschaft können dazu verwendet werden, einen bestimmten Datensatz aus der Datenmenge eines Active Data Object (ADO) zu extrahieren (siehe Eigenschaft recordset). Obwohl diese Eigenschaft für alle IE-Elementobjekte definiert ist, gehören die anderen datenbindungsbezogenen Eigenschaften nur zu bestimmten Elementen. |
|
Beispiel | |
<script for="tableTemplate" event="onclick"> myDataCollection.recordset.absoluteposition = this.recordNumber; ... </script> |
|
Wert | |
Eine ganze Zahl. |
|
Standardwert | |
null |
rightMargin | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt die Breite des rechten Rands des body-Elements im Browserfenster oder Frame in Pixel an. Standardmäßig fügt der Browser einen schmalen Rand ein, damit der Inhalt nicht an den rechten Rand des Fensters anstößt. Die Angabe einer leeren Zeichenfolge für diese Eigenschaft hat die gleiche Wirkung wie der Wert 0. |
|
Beispiel | |
document.body.leftMargin = 16; |
|
Wert | |
Ein ganzzahliger Pixelwert. |
|
Standardwert | |
10 (Windows); 0 (Macintosh). |
scroll | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Legt fest, ob das Fenster (bzw. der Frame) Bildlaufleisten aufweist, wenn der Inhalt die Fenstergröße überschreitet. Wenn in Ihrem Dokument eine standardkompatible DOCTYPE-Definition angegeben ist (siehe Kapitel 8), wirken sich Änderungen am body-Element nicht auf die scroll-Eigenschaft aus. Außerdem ist das html-Elementobjekt entgegen den Angaben in der Microsoft-Entwicklerdokumentation nicht von dieser Eigenschaft abhängig. |
|
Beispiel | |
document.body.scroll = "no"; |
|
Wert | |
Nicht genau ein Boolescher Wert. Erfordert eine der folgenden Zeichenfolgen: yes | no | auto. |
|
Standardwert | |
yes |
scrollHeight, scrollWidth | NN 7 IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Diese Eigenschaften wurden in IE 4 ursprünglich für Elemente implementiert, die entweder selbst einen Bildlauf ausführen oder den Bildlauf eines Elements beeinflussen (body, button, caption, div, fieldset, legend, marquee und textarea), und geben die Abmessungen eines Elements in Pixeln zurück, auch wenn dieses größer ist als der sichtbare Bereich des Browserfensters. Insofern unterscheiden sie sich von den Eigenschaften clientHeight und clientWidth für rollbare Elemente, die nur die Abmessungen sichtbarer Anteile des Elements zurückgeben. IE für den Macintosh interpretiert den Zweck der Bildlaufeigenschaften anders und gibt die Maße der sichtbaren Elementbereiche zurück. |
|
In IE für Windows weisen seit Version 5 alle HTML-Elemente diese Eigenschaften auf, und die Werte für nicht rollende Elemente sind mit denen der Eigenschaften offsetHigh und offsetWidth identisch. Netscape 7 implementiert diese Eigenschaften für alle Elemente und gibt die Höhe und Breite des Elements zurück, unabhängig davon, ob es sich innerhalb oder außerhalb des sichtbaren Bereichs befindet. Wichtig ist hier, dass für Schlüsselelemente, wie z. B. body, die Eigenschaften unterschiedliche Dinge bedeuten und den plattformübergreifenden Betrieb stören können. |
|
Beispiel | |
var midPoint = document.body.scrollHeight/2; |
|
Wert | |
Eine positive ganze Zahl oder Null. |
|
Standardwert | |
Keine. |
scrollLeft, scrollTop | NN 7 IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Stellt den Abstand in Pixeln zwischen dem tatsächlichen linken oder oberen Rand des physischen Inhalts eines Elements und dem linken oder oberen Rand des sichtbaren Teils des Inhalts bereit. Durch Festlegen dieser Eigenschaften können Sie ein Skript verwenden, um den Bildlauf von Inhalten in einem rollbaren Container einstellen, z. B. einen Text in einem textarea-Element oder ein gesamtes Dokument in einem Browserfenster bzw. einem Frame. Können die Inhalte nicht gerollt werden, sind beide Werte Null. Wenn Sie die Eigenschaft scrollTop beispielsweise auf 15 setzen, rollt das Dokument um 15 Pixel im Fenster nach oben; die Eigenschaft scrollLeft wird nicht beeinflusst, soweit sie nicht ausdrücklich geändert wird. Die Eigenschaftswerte ändern sich, wenn der Benutzer die Bildlaufleisten anpasst. Dies ist für bestimmte ereignisgesteuerte Positionierungsaufgaben in IE für Windows von Bedeutung, da sich das Koordinatensystem für Ereignis-Offset-Messungen auf den sichtbaren Bereich einer Seite im Browserfenster bezieht. Sie müssen document.body-Bildlauffaktoren hinzufügen, um Ereigniskoordinaten an den Positionen der Body-Inhalte auszurichten (siehe das Beispiel zum Ziehen von Elementen in Kapitel 6). In IE für Windows ab Version 5 sind die Eigenschaften scrollLeft und scrollTop für alle HTML-Elementobjekte verfügbar, nicht rollbare Elemente weisen jedoch für beide Eigenschaften den Wert Null auf. |
|
Beispiel | |
document.body.scrollTop = 40; |
|
Wert | |
Eine positive ganze Zahl oder Null. |
|
Standardwert | |
0 |
text | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt die Textfarbe für den gesamten Haupttext eines Dokuments an. Entspricht der Vordergrundfarbe. |
|
Beispiel | |
document.body.text = "darkred"; |
|
Wert | |
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A. |
|
Standardwert | |
Die Standardeinstellung des Browsers (kann vom Benutzer angepasst werden). |
topMargin | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt die Breite des oberen Rands des body-Elements im Browserfenster oder Frame in Pixel an. Standardmäßig fügt der Browser einen schmalen Rand ein, damit der Inhalt nicht an den oberen Rand des Fensters anstößt. Die Angabe einer leeren Zeichenfolge für diese Eigenschaft hat die gleiche Wirkung wie der Wert 0. |
|
Beispiel | |
document.body.topMargin = 16; |
|
Wert | |
Ein ganzzahliger Pixelwert. |
|
Standardwert | |
15 (Windows); 8 (Macintosh). |
vLink | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Gibt die Farbe eines Hypertext-Links an, der vor kurzem besucht wurde. Die Farbe wird auf den Hyperlink-Text oder auf den Rahmen eines Bildes oder Objekts angewendet, das in einem a-Element eingebettet ist. Weitere Informationen zu den Farben für nicht besuchte und angeklickte Hyperlinks finden Sie unter den Eigenschaften link und aLink. Die veraltete aber rückwärtskompatible Version dieser Eigenschaft ist die vlinkColor-Eigenschaft des document-Objekts. |
|
Beispiel | |
document.body.vLink = "gold"; |
|
Wert | |
Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A. |
|
Standardwert | |
#551a8b (Navigator 4); #800080 (Internet Explorer 4 Windows); #006010 (Internet Explorer 4 Macintosh). |
createTextRange( ) | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Erstellt ein TextRange-Objekt aus dem im aktuellen Element dargestellten Textinhalt. Weitere Informationen finden Sie unter dem Objekt TextRange. |
|
Parameter | |
Keine. |
|
Zurückgegebener Wert | |
TextRange-Objekt. |
tabIndex | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Dies ist eine Zahl, die die Position dieses Elements innerhalb der Tabulatorreihenfolge aller aktivierbaren Elemente im Dokument angibt. Für die Tabulatorreihenfolge gelten sehr strenge Regeln. Elemente, deren tabIndex-Eigenschaften Werte (nicht Null) zugewiesen wurden, befinden sich in der Reihenfolge an erster Stelle, wenn ein Benutzer die Tabulatortaste auf einer Seite verwendet. Der Fokus beginnt bei dem Element mit dem niedrigsten tabIndex-Wert und folgt der Reihenfolge bis zum höchsten Wert, unabhängig von der physischen Position eines Objekts auf der Seite oder in einem Dokument. Falls zwei Elemente die gleichen tabIndex-Werte aufweisen, erhält das Element, das zuerst im Dokument erscheint, auch zuerst den Fokus. Dann kommen alle Elemente, die entweder die Eigenschaft tabIndex nicht unterstützen oder deren Wert auf Null gesetzt ist. Diese Elemente werden in der Reihenfolge aktiviert, in der sie im Dokument angeordnet sind. |
|
Im W3C-DOM und in Netscape 6 ist die Eigenschaft tabIndex auf folgende Elementobjekte beschränkt: a, area, button, input, object, select und textarea. IE 4 unterstützt es darüber hinaus für die Elemente applet, body, div, embed, isindex, marquee, span, table und td. IE 5 erkennt dieses Attribut in Verbindung mit allen darstellbaren Elementen. Ein negativer Wert entfernt ein Element (nur in IE) vollständig aus der Tabulatorreihenfolge. |
|
Da Hyperlinks und Anker in der Mac-Version von IE 4 nicht über die Tabulatortaste zu erreichen sind, wird die Eigenschaft tabIndex bei a-Elementen in dieser Version ignoriert. |
|
Beispiel | |
document.getElementById("link3").tabIndex = 6; |
|
Wert | |
Eine ganze Zahl. |
|
Standardwert | |
0 |