34.34 Das Window-Objekt   JS 1.0 Ab JavaScript 1.0 Hiermit werden Fenster (oder auch Iframes oder Frames; dannFrames-Objekt) in JavaScript abgebildet. Daswindow-Objekt steht an oberster Stelle in der Objekt-Hierarchie.
34.34.1 Allgemeines  HTML-Tag:<body> oder<frame> oder<iframe>
34.34.2 Event-Handler onbeforeunload (IE) onblur (JS1.1) ondragdrop (JS1.2/IE4) onerror (JS1.1) onfocus (JS1.1) onload onmove (JS1.2/IE4) onresize (JS1.2/IE4) onunload
34.34.3 Methoden alert
| Erklärung | | Gibt ein modales Warnfenster aus. | | Syntax | | alert(Nachricht) | | Parameter | Bedeutung | | Nachricht | Text im Warnfenster |
backJS 1.2
| Erklärung | | Lädt die Seite, die in der History des aktuellen Fensters vor der aktuellen Seite kommt; ab JavaScript 1.2/IE5. |
blurJS 1.1
| Erklärung | | Nimmt den Fokus vom aktuellen Fenster; ab JavaScript 1.1. | | Beispiel | | <body onfocus="window.blur();"> <!-- gemeiner Trick auf vielen Werbefenstern --> |
captureEventsJS 1.2
| Erklärung | | Alle angegebenen Ereignisse werden abgefangen, siehe Kapitel 14; ab JavaScript 1.2, nur Netscape. | | Syntax | | captureEvents(Ereignis1 | Ereignis2 | ... | EreignisN) | | Parameter | Bedeutung | | Ereignis1,Ereignis2, ...,EreignisN | Ereignisse, z. B.Event.MOUSEUP |
clearIntervalJS 1.2
| Erklärung | | Löscht einen mitsetInterval() gesetzten Timeout; ab JavaScript 1.2. | | Syntax | | clearInterval(ID) | | Parameter | Bedeutung | | ID | vonsetInterval() zurückgegebene ID |
clearTimeout
| Erklärung | | Löscht einen mitsetTimeout() gesetzten Timeout. | | Syntax | | clearTimeout(ID) | | Parameter | Bedeutung | | ID | vonsetTimeout() zurückgegebene ID |
close
| Erklärung | | Schließt das Fenster. Wenn es nicht mit JavaScript geöffnet worden ist, erscheint zuvor aus Sicherheitsgründen eine Warnmeldung für den Benutzer. |
confirm
| Erklärung | | Gibt ein modales Hinweisfenster mit zwei Schaltflächen (OK undAbbrechen) aus. Klickt der Benutzer auf OK, wirdtrue zurückgegeben, ansonstenfalse. | | Syntax | | confirm(Nachricht) | | Parameter | Bedeutung | | Nachricht | Text im Hinweisfenster |
disableExternalCaptureJS 1.2
| Erklärung | | Deaktiviert ein vorhergehendesenableExternalCapture(); ab JavaScript 1.2, nur Netscape. |
enableExternalCaptureJS 1.2
| Erklärung | | Gestattet es einem Skript in einem anderen Frame, Ereignisse in diesem Fenster/Frame abzufangen, obwohl es auf einem anderen Server liegt; benötigtUniversalBrowserWrite; ab JavaScript 1.2, nur Netscape. |
find
| Erklärung | | Sucht eine Zeichenkette im aktuellen Browserfenster; ab JavaScript 1.2/IE5. | | Syntax | | find([Zeichenkette[, grossklein, rückwärts]]) | | Parameter | Bedeutung | | Zeichenkette | die zu suchende Zeichenkette | | grossklein | boolescher Wert, der angibt, ob zwischen Groß- und Kleinschreibung unterschieden werden soll (true) oder nicht (false). | | rückwärts | wenntrue, dann wird vom Ende des Dokuments aus gesucht | | Beispiel | | Wenn die Zeichenkette gefunden wird, gibt die Funktiontrue zurück, ansonstenfalse. Wird keine Zeichenkette angegeben, wird das Suchen-Dialogfenster des Browsers aufgerufen. |
focusJS 1.1
| Erklärung | | Gibt dem aktuellen Fenster den Fokus; ab JavaScript 1.1. | | Beispiel | | <body onblur="window.focus();"> <!-- Fenster verbleibt im Vordergrund --> |
forwardJS 1.2
| Erklärung | | Lädt die Seite, die in der History des aktuellen Fensters nach der aktuellen Seite kommt; ab JavaScript 1.2/IE5. |
handleEventJS 1.2
| Erklärung | | Ruft den Event-Handler für ein bestimmtes Ereignis auf; ab JavaScript 1.2, nur Netscape. | | Syntax | | handleEvent(Ereignis) | | Parameter | Bedeutung | | Ereignis | Ereignisobjekt. |
homeJS 1.2
| Erklärung | | Lädt die im Browser eingestellte Startseite; ab JavaScript 1.2/IE5. |
moveByJS 1.2
| Erklärung | | Verschiebt ein Fenster horizontal und vertikal; ab JavaScript 1.2. | | Syntax | | moveBy(hDelta, vDelta) | | Parameter | Bedeutung | | hDelta | relative horizontale Verschiebung | | vDelta | relative vertikale Verschiebung |
moveToJS 1.2
| Erklärung | | Verschiebt ein Fenster an die angegebene Bildschirmposition; ab JavaScript 1.2. | | Syntax | | moveTo(x, y) | | Parameter | Bedeutung | | x | neue x-Koordinate der linken oberen Ecke des Fensters | | y | neue y-Koordinate der linken oberen Ecke des Fensters | | Beispiel | | <a href="#">Fenster nach links oben!</a> |
open
| Erklärung | | Öffnet ein neues Fenster. | | Syntax | | open(URL[, Fenstername[, Optionen]]) | | Parameter | Bedeutung | | URL | die URL des neuen Fensters oder"", wenn es sich um ein leeres Dokument handelt | | Fenstername | name-Eigenschaft des neuen Fensters, dient auch alstarget-Attribut für Hyperlinks | | Optionen | Eigenschaften für das neue Fenster, die im Format"Eigenschaft1=yes,Eigenschaft2=Wert,Eigenschaft3=no" angegeben werden. Nicht genannte Eigenschaften sind in der Regel aufno gesetzt. Äquivalent zuyes ist1, äquivalent zuno ist0. |
Tabelle 34.3 Eigenschaften für neue Fenster | Option | Boolesch/ Numerisch | JavaScript-Version, signiertes Skript | Beschreibung | | alwaysLowered | B | 1.2/SS (nur Netscape) | Fenster liegt immer hinter anderen offenen Fenstern. | | alwaysRaised | B | 1.2/SS (nur Netscape) | Fenster liegt immer über anderen offenen Fenstern. | | channelmode | B | 1.2 (nur Internet Explorer) | Channel-Leiste | | dependent | B | 1.2 (nur Netscape) | Das neue Fenster ist vom öffnenden Fenster abhängig; wird das öffnende Fenster geschlossen, schließt sich auch das neue Fenster. | | directories | B | 1.0 | Directory-Leiste (What’s New etc.) | | fullscrean | B | 1.2 (nur Internet Explorer) | Vollbild (Browser maximiert) | | height | N | 1.0 | Höhe des Fensters | | hotkeys | B | 1.2 (nur Netscape) | Fallsno oder0, werden Tastenkürzel (außerBeenden) im neuen Fenster deaktiviert. | | innerHeight | N | 1.2 (nur Netscape) | Höhe des verfügbaren Bereichs | | innerWidth | N | 1.2 (nur Netscape) | Breite des verfügbaren Bereichs | | left | N | 1.2 (nur Internet Explorer) | x-Koordinate der linken oberen Ecke | | location | B | 1.0 | Adressleiste | | menubar | B | 1.0 | Menüleiste | | outerHeight | N | 1.2 (nur Netscape) | Höhe des Fensters (Nachfolger vonheight) | | outerWidth | N | 1.2 (nur Netscape) | Breite des Fensters (Nachfolger vonwidth) | | personalbar | B | 1.2 (nur Netscape) | »Personal Toolbar« | | resizable | B | 1.0 | Fenster in der Größe nicht veränderbar, fallsno oder0 | | screenX | N | 1.2 (nur Netscape) | x-Koordinate der linken oberen Ecke | | screenY | N | 1.2 (nur Netscape) | y-Koordinate der linken oberen Ecke | | scrollbars | B | 1.0 | Scrollleisten | | status | B | 1.0 | Statuszeile | | titlebar | B | 1.0 | Titelleiste | | toolbar | B | 1.0 | Werkzeugleiste | | top | N | 1.2 (nur Internet Explorer) | y-Koordinate der linken oberen Ecke | | width | N | 1.0 | Breite des Fensters | | z-lock | B | 1.2/SS (nur Netscape) | Fenster liegt über anderen Fenstern. |
Die Methode gibt eine Referenz auf das neue Fenster zurück. printJS 1.2
| Erklärung | | Ruft denDrucken-Dialog des Browsers für den aktuellen Frame bzw. das aktuelle Fenster auf; ab JavaScript 1.2/IE5. |
prompt
| Erklärung | | Zeigt ein Eingabefenster an; der Benutzer kann einen Text eingeben, der dann von der Funktion zurückgegeben wird. | | Syntax | | prompt(Nachricht[, Vorausfüllung]) | | Parameter | Bedeutung | | Nachricht | Hinweistext im Eingabefenster. Wird dieser nicht angegeben, erscheint"<undefined>" | | Vorausfüllung | Vorausfüllung für das Textfeld im Eingabefenster. Es gelten dieselben Hinweise wie für den ersten Parameter. Es empfiehlt sich also, zumindest eine leere Zeichenkette zu übergeben |
releaseEventsJS 1.2
| Erklärung | | Deaktiviert ein vorhergehendescaptureEvents(); ab JavaScript 1.2, nur Netscape. | | Syntax | | releaseEvents(Ereignis1 | Ereignis2 | ... | EreignisN) | | Parameter | Bedeutung | | Ereignis1,Ereignis2, ...,EreignisN | Ereignisse, z. B.Event.MOUSEUP |
resizeByJS 1.2
| Erklärung | | Verändert die Ausmaße eines Fensters um einen gewissen Wert, wobei die linke obere Ecke fix bleibt; ab JavaScript 1.2.Ohne ein signiertes Skript ist die minimale Fenstergröße 100 x 100 Pixel. | | Syntax | | resizeBy(hDelta, vDelta) | | Parameter | Bedeutung | | hDelta | relative horizontale Veränderung in Pixeln | | vDelta | relative vertikale Veränderung in Pixeln |
resizeToJS 1.2
| Erklärung | | Verändert die Ausmaße eines Fensters auf einen gewissen Wert, wobei die linke obere Ecke fix bleibt; ab JavaScript 1.2.Ohne ein signiertes Skript ist die minimale Fenstergröße 100 x 100 Pixel. | | Syntax | | resizeTo(Breite, Höhe) | | Parameter | Bedeutung | | Breite | neue Breite des Fensters | | Höhe | neue Höhe des Fensters | | Beispiel | | <a href="#">Fenster verkleinern</a> |
routeEventJS 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 | | routeEvent(Ereignis) | | Parameter | Bedeutung | | Ereignis | Ereignisobjekt |
scrollJS 1.1
| Erklärung | | Scrollt den Inhalt des Fensters bzw. Frames an die angegebene Position; ab JavaScript 1.1. | | Syntax | | scroll(x, y) | | Parameter | Bedeutung | | x | x-Koordinate der Stelle im Dokument, die sich nach dem Scrollen in der linken oberen Ecke des Fensters befinden soll | | y | y-Koordinate der Stelle im Dokument, die sich nach dem Scrollen in der linken oberen Ecke des Fensters befinden soll | | Beispiel | | <a href="#">Nach oben</a> |
scrollByJS 1.2
| Erklärung | | Scrollt den Fensterinhalt um einen gewissen Wert; ab JavaScript 1.2. | | Syntax | | scrollBy(hDelta, vDelta) | | Parameter | Bedeutung | | hDelta | relative horizontale Veränderung in Pixeln | | vDelta | relative vertikale Veränderung in Pixeln |
scrollToJS 1.2
| Erklärung | | Scrollt den Inhalt des Fensters bzw. Frames an die angegebene Position; ab JavaScript 1.2.Die Funktionsweise vonscrollTo() ist identisch mit der vonscroll(). | | Syntax | | scrollTo(x, y) | | Parameter | Bedeutung | | x | x-Koordinate der Stelle im Dokument, die sich nach dem Scrollen in der linken oberen Ecke des Fensters befinden soll | | y | y-Koordinate der Stelle im Dokument, die sich nach dem Scrollen in der linken oberen Ecke des Fensters befinden soll | | Beispiel | | <a href="#">Nach oben</a> |
setHotKeysJS 1.2
| Erklärung | | Schaltet Tastenkürzel in einem Fenster ohne Menü ein oder aus; ab JavaScript 1.2, nur Netscape. Standardmäßig sind Hotkeys aktiviert. | | Syntax | | setHotKeys(anaus) | | Parameter | Bedeutung | | anaus | true= an,false= aus | | Beispiel | | <a href=" window.setHotKeys(false);">Hotkeys deaktivieren</a> |
setIntervalJS 1.2
| Erklärung | | Führt eine Anweisung periodisch aus; ab JavaScript 1.2 und Internet Explorer 4.Die Methode liefert einen Identifier zurück, der mitclearTimeout() zum Löschen des Timeouts verwendet werden kann; ansonsten werden die Anweisungen beliebig oft ausgeführt. | | Syntax | | setInterval(Anweisung, Zeitspanne[, Argument1, ..., ArgumentN]) | | Parameter | Bedeutung | | Anweisung | die Anweisung(en), die ausgeführt werden soll(en) | | Zeitspanne | Zeitspanne in Millisekunden, die zwischen den Ausführungen der Anweisung verstreichen soll | | Argument1, ...,ArgumentN | sofern als Anweisung eine Referenz auf eine Funktion übergeben wird (also der Name, nicht in Anführungszeichen, ohne Klammern), die Argumente, die an die Funktion übergeben werden |
setTimeout
| Erklärung | | Führt eine Anweisung einmal, nach Ablauf einer gewissen Zeitspanne, aus.Die Methode liefert einen Identifier zurück, der mitclearTimeout() zum Löschen des Timeouts verwendet werden kann. | | Syntax | | setTimeout(Anweisung, Zeitspanne[, Argument1, ..., ArgumentN]) | | Parameter | Bedeutung | | Anweisung | die Anweisung, die ausgeführt werden soll (kann auch mehrere Anweisungen enthalten) | | Zeitspanne | Zeitspanne in Millisekunden | | Argument1, ...,ArgumentN | sofern als Anweisung eine Referenz auf eine Funktion übergeben wird (also der Name, nicht in Anführungszeichen, ohne Klammern), die Argumente, die an die Funktion übergeben werden |
setResizableJS 1.2
| Erklärung | | Schaltet die Vergrößerungs- und Verkleinerungsfähigkeit eines Fensters ein oder aus; ab JavaScript 1.2/IE5. | | Syntax | | setResizable(anaus) | | Parameter | Bedeutung | | anaus | true= an,false= aus |
stopJS 1.2
| Erklärung | | Bricht das Laden des Fensterinhalts ab wie die Stop-Schaltfläche in der Werkzeugleiste des Browsers; ab JavaScript 1.2/IE5. |
setZOptionsJS 1.2
| Erklärung | | Mit dieser Option kann das Darstellungsverhalten eines Fensters in Bezug auf andere Fenster (im Vordergrund/im Hintergrund) eingestellt werden; ab JavaScript 1.2, nur Netscape. | | Syntax | | setZOptions(Einstellung) | | Parameter | Bedeutung | | Einstellung | Zeichenkette mit dem Wert"alwaysLowered","alwaysRaised" oder"z-lock" |
showModalDialogJS 1.3
| Erklärung | | Zeigt ein modales Fenster an (siehe auch Kapitel 8); ab JavaScript 1.3, nur Internet Explorer. | | Syntax | | showModalDialog(URL[, Fenstername[, Optionen]]) | | Parameter | Bedeutung | | URL | die URL des neuen Fensters oder"", wenn es sich um ein leeres Dokument handelt | | Fenstername | name-Eigenschaft des neuen Fensters, dient auch alstarget-Attribut für Hyperlinks | | Parameter | Bedeutung | | Optionen | Eigenschaften für das neue Fenster, die im Format"Eigenschaft1=yes, Eigenschaft2=Wert,Eigenschaft3=no" angegeben werden. Nicht genannte Eigenschaften sind in der Regel aufno gesetzt. Äquivalent zuyes ist1, äquivalent zuno ist0. |
showModelessDialogJS 1.3
| Erklärung | | Zeigt ein halbmodales Fenster an (ist immer im Vordergrund, aber auf das aufrufende Fenster kann zugegriffen werden); ab JavaScript 1.3, nur Internet Explorer. | | Syntax | | showModelessDialog(URL[, Fenstername[, Optionen]]) | | Parameter | Bedeutung | | URL | die URL des neuen Fensters oder"", wenn es sich um ein leeres Dokument handelt | | Fenstername | name-Eigenschaft des neuen Fensters, dient auch alstarget-Attribut für Hyperlinks | | Optionen | Eigenschaften für das neue Fenster, die im Format"Eigenschaft1=yes,Eigenschaft2=Wert,Eigenschaft3=no" angegeben werden. Nicht genannte Eigenschaften sind in der Regel aufno gesetzt. Äquivalent zuyes ist1, äquivalent zuno ist0. |
34.34.4 Eigenschaften closedJS 1.1
| Erklärung | | Boolesche Variable, die angibt, ob das Fenster (das zuvor mitwindow.open() geöffnet worden ist) geschlossen ist oder nicht; ab JavaScript 1.1. |
defaultStatus
| Erklärung | | Standardtext in der Statuszeile, der angezeigt wird, wenn sich die Maus über keinem Link befindet. |
document
| Erklärung | | document-Objekt des aktuellen Fensters. |
frames
| Erklärung | | Array, das Referenzen auf alle Frames im aktuellen Fenster enthält, sofern vorhanden. |
history
| Erklärung | | history-Objekt des aktuellen Fensters. |
innerHeightJS 1.2
| Erklärung | | Höhe des zur Verfügung stehenden Bereichs des Browsers (also ohne Scrollbalken etc.); ab JavaScript 1.2. | | Beispiel | | alert("Verfügbarer Bereich: " + window.innerWidth + "x" + window.innerHeight); |
innerWidthJS 1.2
| Erklärung | | Breite des zur Verfügung stehenden Bereichs des Browsers (also ohne Titelleiste etc.); ab JavaScript 1.2. | | Beispiel | | alert("Verfügbarer Bereich: " + window.innerWidth + "x" + window.innerHeight); |
length
| Erklärung | | Anzahl der Frames im aktuellen Fenster. |
location
| Erklärung | | location-Objekt des Fensters. |
locationbarJS 1.2
| Erklärung | | Objekt für die Adressleiste des Fensters; die boolesche Eigenschaftvisible gibt an, ob sie sichtbar ist oder nicht; ab JavaScript 1.2. |
menubarJS 1.2
| Erklärung | | Objekt für die Menüleiste des Fensters, die boolesche Eigenschaftvisible gibt an, ob sie sichtbar ist oder nicht; ab JavaScript 1.2. |
name
| Erklärung | | Identifikator für das Fenster oder den Frame. Er kann unter anderem als Wert für dastarget-Attribut eines Hyperlinks verwendet werden. |
offscreenBufferingJS 1.2
| Erklärung | | Boolescher Wert, der angibt, ob die Aktualisierungen des Fensterinhalts in einem Speicherpuffer ausgeführt werden; falls ja (true), flackert der Bildschirmaufbau weniger, es werden aber mehr Ressourcen benötigt. Der Standardwert istfalse; ab JavaScript 1.2. |
openerJS 1.1
| Erklärung | | Referenz auf das Fenster, das das aktuelle Fenster via JavaScript geöffnet hat (sofern das der Fall war, ansonsten ist der Wertnull); ab JavaScript 1.1 und Internet Explorer 3. | | Beispiel | | window.opener.location.href = "http://www.galileo-press.de";//im öffnenden Fenster Galileo-Homepage laden |
outerHeightJS 1.2
| Erklärung | | Höhe des Browserfensters (also mit Scrollbalken etc.); ab JavaScript 1.2. |
outerWidthJS 1.2
| Erklärung | | Breite des Browserfensters (also mit Titelleiste etc.); ab JavaScript 1.2. |
pageXOffsetJS 1.2
| Erklärung | | x-Koordinate des Punkts des aktuellen Dokuments, der sich in der linken oberen Ecke des Fensters befindet; ab JavaScript 1.2. |
pageYOffsetJS 1.2
| Erklärung | | y-Koordinate des Punkts des aktuellen Dokuments, der sich in der linken oberen Ecke des Fensters befindet; ab JavaScript 1.2. |
parent
| Erklärung | | Referenz auf das übergeordnete Fenster; ist ein Verweis auf das aktuelle Fenster, falls kein Frame. |
personalbarJS 1.2
| Erklärung | | Objekt für die »Personal Toolbar« des Fensters; die boolesche Eigenschaftvisible gibt an, ob sie sichtbar ist oder nicht; ab JavaScript 1.2. |
screenLeftJS 1.2
| Erklärung | | x-Koordinate der linken oberen Ecke des Fensters, relativ zum Bildschirm; ab JavaScript 1.2, nur Internet Explorer 5. |
screenTopJS 1.2
| Erklärung | | y-Koordinate der linken oberen Ecke des Fensters, relativ zum Bildschirm; ab JavaScript 1.2, nur Internet Explorer 5. |
screenXJS 1.2
| Erklärung | | x-Koordinate der linken oberen Ecke des Fensters, relativ zum Bildschirm; ab JavaScript 1.2, nur Netscape. |
screenYJS 1.2
| Erklärung | | y-Koordinate der linken oberen Ecke des Fensters, relativ zum Bildschirm; ab JavaScript 1.2, nur Netscape. |
scrollbarsJS 1.2
| Erklärung | | Objekt für die Scrollleisten des Fensters; die boolesche Eigenschaftvisible gibt an, ob sie sichtbar sind oder nicht; ab JavaScript 1.2. |
self
| Erklärung | | Referenz auf das aktuelle Fenster bzw. den aktuellen Frame. |
status
| Erklärung | | Text in der Statuszeile. Im Gegensatz zudefaultStatus wird dieser Text nur so lange angezeigt, bis beispielsweise die Maus über einen Link fährt; verlässt die Maus den Link wieder, wird erneutdefaultStatus angezeigt. |
statusbarJS 1.2
| Erklärung | | Objekt für die Statusleiste des Fensters; die boolesche Eigenschaftvisible gibt an, ob sie sichtbar ist oder nicht; ab JavaScript 1.2. |
toolbarJS 1.2
| Erklärung | | Objekt für die Werkzeugleiste des Fensters; die boolesche Eigenschaftvisible gibt an, ob sie sichtbar ist oder nicht; ab JavaScript 1.2. |
top
| Erklärung | | Referenz auf das oberste Fenster in der Frame-Hierarchie. Ist das aktuelle Fenster selbst das oberste, so zeigt diese Eigenschaft auf das Fenster selbst. |
|
