34.6 Das document-Objekt  
JS 1.0
Ab JavaScript 1.0
Mit dem document-Objekt kann man auf die HTML-Seite zugreifen und auch HTML-Seiten erzeugen.
34.6.1 Allgemeines 
HTML-Tag: <body>
34.6.2 Event-Handler
onclick ondblclick (JS1.2) onkeydown (JS1.2) onkeypress (JS1.2) onkeyup (JS1.2)
onmousedown (JS1.2) onmouseup (JS1.2)
34.6.3 Methoden
captureEvents
JS 1.2
| Erklärung
|
| Alle angegebenen Ereignisse werden abgefangen, siehe Kapitel 14, »Ereignisbehandlung«; ab JavaScript 1.2, nur Netscape.
|
| Syntax
|
| document.captureEvents(Ereignis1 | Ereignis2 | ... | EreignisN)
|
| Parameter
|
Bedeutung
|
| Ereignis1, Ereignis2, ..., EreignisN
|
Ereignisse, z. B. Event.MOUSEUP
|
close
| Erklärung
|
| Beendet eine mit document.open() gestartete Ausgabe und bringt den Browser dazu, diese Ausgabe zu rendern.
|
| Syntax
|
| document.open();
document.write("Read my lips");
document.close();
|
contextual
JS 1.2
| Erklärung
|
| Setzt Styles für Elemente innerhalb eines bestimmten Kontextes; ab JavaScript 1.2, nur Netscape.
|
| Syntax
|
| contextual(Kontext1, Kontext2, ..., KontextN, Stil)
|
| Parameter
|
Bedeutung
|
| Kontext1, Kontext2, ..., KontextN
|
Ereignisse, z. B. Event.MOUSEUP
|
| Stil
|
der zu ändernde Style
|
| Beispiel
|
| Aufgrund des folgenden Codes werden alle fett gedruckten Zeichen innerhalb eines Absatzes grün angezeigt:
contextual(document.tags.P, document.tags.B).color = "green";
|
getSelection
JS 1.2
| Erklärung
|
| Gibt den gerade markierten Text des Dokuments zurück; ab JavaScript 1.2.
Diese Methode kann nicht von anderen Frames aus aufgerufen werden (Sicherheitsvorkehrung).
|
handleEvent
JS 1.2
| Erklärung
|
| Ruft den Event-Handler für ein bestimmtes Ereignis auf; ab JavaScript 1.2, nur Netscape.
|
| Syntax
|
| document.handleEvent(Ereignis)
|
| Parameter
|
Bedeutung
|
| Ereignis
|
Ereignisobjekt
|
| Beispiel
|
| Für Anwendungsbeispiele siehe Kapitel 14.
|
open
| Erklärung
|
| Initiiert eine Ausgabe von HTML-Code mittels JavaScript; dies wird jedoch erst sichtbar, wenn die Ausgabe mit document.close() beendet wird. Bestehender HTML-Code wird dabei überschrieben, ein Anhängen ist also nicht möglich.
|
| Syntax
|
| document.open() //ab JavaScript 1.0
document.open(MIME_Type) //Netscape, Internet Explorer ab //Version 4
document.open(MIME_Type, ersetzen) //nur ab Netscape 4
|
| Parameter
|
Bedeutung
|
| MIME_Type
|
MIME-Typ der folgenden Daten. In der Regel ist das "text/html" (und der Internet Explorer lässt nur diesen Typ zu), aber möglich sind auch beispielsweise "image/gif" oder "plugIn".
|
| ersetzen
|
boolesche Variable, die angibt, ob das neue Dokument das alte in der History-Liste des Browsers ersetzen soll
|
| Beispiel
|
| document.open();
document.write("Read my lips");
document.close();
|
releaseEvents
JS 1.2
| Erklärung
|
| Deaktiviert ein vorhergehendes captureEvents(); ab JavaScript 1.2, nur Netscape.
|
| Syntax
|
| document.releaseEvents(Ereignis1 | Ereignis2 | ... | EreignisN)
|
| Parameter
|
Bedeutung
|
| document.releaseEvents(Ereignis1 | Ereignis2 | ... | EreignisN)
|
Ereignisse, z. B. Event.MOUSEUP.
|
| Beispiel
|
| Für Anwendungsbeispiele siehe Kapitel 14.
|
routeEvent
JS 1.2
| Erklärung
|
| Führt ein abgefangenes Ereignis an der Stelle aus, für die es bestimmt war; ab JavaScript 1.2, nur Netscape.
|
| Syntax
|
| document.routeEvent(Ereignis)
|
| Parameter
|
Bedeutung
|
| Ereignis
|
Ereignisobjekt.
|
| Beispiel
|
| Für Anwendungsbeispiele siehe Kapitel 14.
|
write
| Erklärung
|
| Gibt HTML-Code mittels JavaScript aus; dies wird jedoch erst sichtbar, wenn die Ausgabe mit document.close() beendet wird. Ein vorhergehendes document.open() ist optional.
|
| Syntax
|
| document.write(Text)
|
| Parameter
|
Bedeutung
|
| Text
|
auszugebender Text.
|
| Beispiel
|
| document.open();
document.write("Read my lips");
document.close();
|
writeln
| Erklärung
|
| Gibt HTML-Code mittels JavaScript aus und fügt – im Gegensatz zu document.write() – einen Zeilenvorschub an.
|
| Syntax
|
| document.writeln([Text])
|
| Parameter
|
Bedeutung
|
| Text
|
auszugebender Text.
|
| Beispiel
|
| Wird kein Parameter angegeben, so wird eine Leerzeile ausgegeben. Diese ist jedoch bei HTML-Dokumenten im Allgemeinen nicht sichtbar.
document.open();
document.writeln("<pre>");
document.writeln("Read my lips");
document.writeln("</pre>");
document.close()
|
34.6.4 Eigenschaften
alinkColor
| Erklärung
|
| Farbe eines aktiven Links (während er angeklickt wird, bevor der Benutzer die Maustaste wieder loslässt). HTML-Äquivalent: <body alink="Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
|
| Beispiel
|
| document.alinkColor = "red";
document.alinkColor = "#ff0000";
|
all
| Erklärung
|
| Ermöglicht den Zugriff auf Style-Eigenschaften; ab Internet Explorer 4. Neuere Versionen des Internet Explorer setzen auf document.getElementById().
|
anchors
| Erklärung
|
| Array, das alle Textmarken im Dokument enthält. Siehe Abschnitt 34.1.
|
applets
| Erklärung
|
| Array, das alle Applets im Dokument enthält. Zu Interaktion mit Java siehe Kapitel 24.
|
bgColor
| Erklärung
|
| Hintergrundfarbe des Dokuments. HTML-Äquivalent: <body bgcolor= "Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
|
| Beispiel
|
| document.bgColor = "white";
document.bgColor = "#ffffff";
|
classes
JS 1.2
| Erklärung
|
| Erzeugt eine Style-Sheet-Klasse, die im HTML-Code angesprochen werden kann; ab JavaScript 1.2, nur Netscape.
|
| Beispiel
|
| <style type="text/javascript">
classes.GalileoBlau.all.color = "blue";
</style>
<script type="text/javascript">
document.classes.GalileoBlau.all.color = "blue";
</script>
|
cookie
| Erklärung
|
| Zeichenkette, die alle Cookies enthält, auf die von der HTML-Seite aus zugegriffen werden darf. Für Anwendungen siehe Kapitel 12.
|
domain
JS 1.1
| Erklärung
|
| Enthält den Domainnamen des Servers, auf dem die aktuelle HTML-Seite liegt; ab JavaScript 1.1.
Aufgrund von Sicherheitsbestimmungen hat man von JavaScript aus von einem Dokument mit dem Domainnamen www.server.de keinen Zugriff auf gewisse Objekte in einem anderen Frame mit dem Domainnamen www2.server.de; hier sollte man document.domain auf server.de setzen, damit der Zugriff wieder funktioniert.
|
embeds
JS 1.1
| Erklärung
|
| Array, das alle mit dem <embed>-Tag eingefügten Daten enthält (bzw. zumindest deren Anzahl); ab JavaScript 1.1.
|
| Beispiel
|
| alert("Dieses Dokument enthält " + document.embeds.length + " eingebettete Dateien")
|
fgColor
| Erklärung
|
| (Vordergrund-)Farbe des Dokuments. HTML-Äquivalent: <body color= "Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
|
| Beispiel
|
| document.fgColor = "black"
document.fgColor = "#000000"
|
forms
| Erklärung
|
| Array, das alle Formulare in einem HTML-Dokument enthält. Siehe Kapitel 9.
|
| Syntax
|
| document.forms[Index]
document.forms["FormularName"]
document.FormularName
|
| Parameter
|
Bedeutung
|
| Index
|
Nummer des Formulars im Dokument (bei mehreren Formularen); die Zählung beginnt bei 0
|
| FormularName
|
name-Attribut des Formulars
|
height
JS 1.2
| Erklärung
|
| Höhe eines Dokuments (in Pixeln); ab JavaScript 1.2.
|
ids
JS 1.2
| Erklärung
|
| Erzeugt einen Style-Sheet-Identifikator; ab JavaScript 1.2.
|
images
JS 1.1
| Erklärung
|
| Array, das alle Grafiken innerhalb eines HTML-Dokuments enthält; ab JavaScript 1.1 (und Internet Explorer 3 für Macintosh).
|
| Syntax
|
| document.images[Index]
document.images["BildName"]
document.BildName
|
| Parameter
|
Bedeutung
|
| Index
|
Nummer der Grafik im Dokument; die Zählung beginnt bei 0
|
| BildName
|
name-Attribut der Grafik
|
| Beispiel
|
| Siehe Kapitel 11.
|
lastModified
| Erklärung
|
| Datum der letzten Änderung der Datei als Zeichenkette.
Dieser Wert wird aus dem HTTP-Header gewonnen, und die Daten darin werden zumeist vom Server aus dem Änderungsdatum der Datei auf dem Server bestimmt.
|
| Beispiel
|
| document.write("Letzte Änderung: " +
document.lastModified);
|
layers
JS 1.2
| Erklärung
|
| Array, das alle Layer innerhalb eines HTML-Dokuments enthält; ab JavaScript 1.2, nur Netscape.
|
| Syntax
|
| document.layers[Index]
document.layers["LayerName"]
document.LayerName
|
| Parameter
|
Bedeutung
|
| Index
|
Nummer des Layers im Dokument; Zählung beginnt bei 0
|
| LayerName
|
name-Attribut des Layers
|
linkColor
| Erklärung
|
| Linkfarbe des Dokuments. HTML-Äquivalent: <body link="Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
|
| Beispiel
|
| document.linkColor = "blue";
document.linkColor = "#0000ff";
|
links
| Erklärung
|
| Array, das alle Hyperlinks innerhalb eines HTML-Dokuments enthält.
|
| Syntax
|
| document.links[Index]
|
| Parameter
|
Bedeutung
|
| Index
|
Nummer des Links im Dokument; Zählung beginnt bei 0
|
| Beispiel
|
| Siehe Abschnitt 1.15.
|
plugins
JS 1.1
| Erklärung
|
| Array, das alle Plugins innerhalb eines HTML-Dokuments enthält; ab JavaScript 1.1, nur Netscape.
Siehe Kapitel 22.
|
referrer
| Erklärung
|
| URL der Seite, von der aus die aktuelle Seite aufgerufen wurde; entspricht dem HTTP-Header Referer.
|
| Beispiel
|
| document.write("Sie kommen von " + document.referer);
Bei einigen Browsern lässt sich die Übermittlung der vorhergehenden Seite unterbinden.
|
tags
JS 1.2
| Erklärung
|
| Erzeugt eine Style-Sheet-Klasse für ein gewisses Tag, die im HTML-Code angesprochen werden kann; ab JavaScript 1.2, nur Netscape.
|
| Beispiel
|
| Der folgende Code sorgt dafür, dass alle Level-3-Überschriften in blauer Farbe dargestellt werden:
document.tags.H3.all.color = "blue";
|
title
| Erklärung
|
| Titel des Dokuments; HTML-Äquivalent: <title>Titel</title>; kein Schreibzugriff.
|
URL
JS 1.1
| Erklärung
|
| Die komplette URL des aktuellen Dokuments als Zeichenkette; ab JavaScript 1.1. Ersatz für document.location, nicht zu verwechseln mit window.location.
|
vlinkColor
| Erklärung
|
| Farbe für besuchte Links des Dokuments. HTML-Äquivalent: <body vlink="Farbe">. Als Farbe wird entweder ein hexadezimales RGB-Tripel oder ein Farbcode übergeben.
|
| Beispiel
|
| document.vlinkColor = "red";
document.vlinkColor = "#ff0000";
|
width
JS 1.2
| Erklärung
|
| Breite des Dokuments in Pixeln; ab JavaScript 1.2.
|
|
