Window è un oggetto che corrisponde alla finestra che visualizza una pagina web. Tale finestra può essere creata dinamicamente.
Questo non è un oggetto JavaScript, e non è definito dalla specifica W3C DOM. È uno standard de facto.
Gli attributi e i metodi della finestra di interfaccia sono riconosciuti da Internet Explorer 4, Firefox 1, Opera 9, versioni più recenti e Safari. Questo documento si basa su ciò che è supportato dai browser in assenza di uno standard ufficiale, vedi riferimenti.
La finestra corrente è indicata dalla parola chiave window, e le finestre create dinamicamente dal nome dato all’oggetto assegnato dal valore di ritorno del metodo open.
Definizione e test degli attributi e degli oggetti interni di window
Definizioni degli attributi e degli oggetti interni
Questi attributi possono essere letti solo per alcuni, il loro valore può essere assegnato altrimenti.
frames I frame nella finestra. Sola lettura. length Numero di frame. Solo lettura. name Nome della finestra. status Testo della barra di stato
In Firefox, la modifica del testo è un’opzione. Vai su Opzioni, Contenuto, JavaScript e clicca sul pulsante Avanzate. Poi spunta la casella accanto a “Cambia il testo della barra di stato”. defaultStatus Testo predefinito nella barra di stato. closed Stato chiuso o no. opener Riferimento sulla finestra che ha aperto questa finestra. Esempio:
x = window.opener;parent Il genitore di una finestra. Esempio:
x = mywin.parent;top Il genitore del livello più alto.
Oggetti nella finestra
Questi oggetti hanno i loro propri attributi e metodi che non sono dettagliati qui ma hanno la loro propria pagina.
documento Si riferisce ad una pagina, che è contenuta nella finestra. Document. history Elenco di pagine precedentemente visualizzate nella stessa finestra. History. location Indica l’URL di una pagina che contiene la finestra. Location. screen Lo schermo e le sue proprietà: larghezza, altezza, availWidth, availHeight, colorDepth.
Vedi anche le proprietà per la creazione della finestra nel capitolo: Aprire una nuova finestra in JavaScript.
Controllare le proprietà dell’oggetto Windows nel browser
Le proprietà non supportate da un browser sono indefinite.
Alcune proprietà sono usate come parametri del costruttore della finestra ma non sono direttamente accessibili e non sono elencate qui.
innerWidth innerHeight
outerWidth outerHeight
locationbar menubar personalbar statusbar toolbar scrollbars
pageXOffset pageYOffset
screenX screenY
directories
status defaultStatus
open
parent
top
name
length
Non funziona con Firefox 7
offscreenBuffering
Si possono ottenere valori equivalenti in Internet Explorer e con tutti i browser:
document.body.clientHeight
document.body.clientWidth
document.body.offsetHeight
document.body.offsetWidth
document.documentElement.offsetHeight
document.documentElement.offsetWidth
Others
Crypto
Avviso: La dichiarazione DOCTYPE potrebbe avere un effetto su questi valori.
Metodi di finestra e demo
I metodi per aprire o chiudere una finestra sono descritti nel capitolo: Aprire una nuova finestra in JavaScript.
Definizioni dei metodi alert(message) Visualizza un messaggio. x = prompt(message) Presenta una finestra di dialogo che richiede una risposta dall’utente e restituisce la risposta. x = confirm(message) Visualizza un messaggio, normalmente una domanda, con due pulsanti per confermare o annullare. Restituisce vero o falso. resizeTo(w, h) Ridimensiona la larghezza e l’altezza. scrollTo(x, y) Lo scorrimento deve essere abilitato per la finestra secondo il flag scrollbars, questo è il caso di default. moveTo(x, y) Si sposta nella posizione data. id = setInterval(expression, millisecondi) Valuta un’espressione ripetutamente secondo il tempo in intervallo. clearInterval(id) Cancella l’intervallo. id = setTimeout(expression, millisecondi) Valuta un’espressione dopo la scadenza. clearTimeout(id) Cancella il ritardo. focus() Passa il focus alla finestra. blur() Sopprime il focus alla finestra corrente/data. createPopup() Crea una sottofinestra. print() Inizia la stampa del contenuto della finestra. Dimostrazione dei metodi dell’oggetto finestra HTML Cliccate su un pulsante per vedere come funziona un metodo. Il codice corrispondente è visualizzato a destra.
Vedi anche
Un esempio di utilizzo di setTimeout è incluso nella demo della lightbox con effetto fade in.