L'oggetto Window è l'oggetto gerarchicamente più importante nel linguaggio VbScript perché contiene tutti gli oggetti che vengono comunemente utilizzati nella programmazione. Gli oggetti in questione sono:
- Frame
- Document
- History
- Navigator
- Location
- Script
Come richiamare l'oggetto window
È possibile richiamarlo con la parola chiave "window" per esempio:
window.alert "Hello Word"
Il comando precedente chiama il metodo alert della finestra del browser, permettendo di visualizzare il messaggio selezionato, in questo caso "Hello Word". Poiché l'oggetto window è il primo della gerarchia, non è necessario chiamarlo esplicitamente: è anche possibile trasformare il comando indicato in questo modo:
Alert "Hello Word"
Le proprietà dell'oggetto Window
Proprietà che restituiscono un'oggetto window e sono di sola lettura:
- Parent. Restituisce l'oggetto Window della finestra superiore (gerarchicamente) ,se la finestra superiore è la corrente, parent restituirà la pagina corrente.
- Self. Restituisce l'oggetto window corrente.
- Top. Restituisce l'oggetto window principale.
Proprietà che restituiscono altri oggetti associati all'oggetto Window, anch'essi di sola lettura.
- Frame. Restituisce una matrice di frame contenuti nella finestra corrente. Gli oggetti Frame hanno le stesse proprietà dell'oggetto window.
Vediamo di analizzare un esempio di quest'ultima proprietà:
Window.Frames(1).Location.href ="http://pro.html.it"
Analizziamo l'esempio individuando alcune istruzioni chiave:
Frames(1), come vedete la proprietà frame restituisce un'array che contiene tutti i frame della pagina corrente e in questo caso stiamo scegliendo il frame numero 1.
Location.href ="http://pro.html.it", impostando il metodo href facciamo in modo che il frame venga reindirizzato alla pagina internet selezionata.
Per conoscere il numero di frame contenuti in una pagina si può utilizzare la seguente istruzione:
Window.Frames.Count
La proprietà Count dell'insieme Frames restituisce 0 se non esiste nessun frame nella finestra corrente.
I metodi dell'oggetto Window
- Confirm. Visualizza una finestra di sistema contenente un messaggio e due pulsanti: ok e cancel. Se l'utente fa click su ok il metodo restituisce un valore true. Per analogia se viene cliccato cancel restituisce false.
Esempio:
rest = Confirm("Sei sicuro di voler uscire?")
if rest = true then
alert("Hai cliccato Ok")
Else
alert("Hai cliccato Cancel")
End if - Prompt. Sollecita l'input di testo da parte dell'utente, visualizzando una finestra contenente il messaggio selezionato e una casella di testo.
La sintassi è la seguente:
stringa = Prompt(messaggio,stringadefault)
Con i seguenti parametri
- messaggio. In questo parametro va inserito il messaggio da visualizzare.
- Stringadefault. Questo parametro permette di decidere il valore di default della casella di testo.
Esempio:
str = Prompt ("Inserisci il tuo Nome","---name-") Alert "Ciao "& str
- Open. Crea una nuova finestra nel browser permettendo di controllarne l'aspetto. La sintassi è la seguente:
z = window.open(url,nomefinestra,"lista opzioni")
Con i seguenti parametri
- url. Contiene l'url a cui deve puntare la nuova finestra
- nomefinestra. Contiene il nome della finestra.
- Lista opzioni:
- directories = yes!no
- height = integer
- menubar = yes!no
- width = integer
- resizeable = yes!no
- scrollbars = yes!no
- Close. Chiude una finestra. La sintassi è semplicemente
Window.Close
- SetTimeout e ClearTimeout. SetTimeout imposta un timer che può essere usato per chiamare una procedura una volta trascorso un numero x di millisecondi.
Un esempio su come far partire il timer:
ID = window.setTimeout (espr,millisecondi)
I parametri sono i seguenti:
- Espr: indica la funzione da chiamare
- Millisecondi: indica il numero di millisecondi dopo i quali viene eseguita espr
Per stoppare il timer basta utilizzare il seguente codice:
clearTimeout ID
- Navigate: Carica nella finestra il file specificato da un Url. Si utilizza con
Window.Navigate Url
L'oggetto Frame
Un oggetto Frame è un particolare tipo di oggetto Window e ne possiede le medesime proprietà, per cui può essere utilizzato allo stesso modo; l'unica cosa cui prestare attenzione è sostituire i riferimenti dell'oggetto window con quelli dell'oggetto Frame.
L'oggetto History
L'oggetto History rappresenta la Cronologia dei documenti aperti.
Proprietà dell'oggetto History
L'oggetto history ha una sola proprietà: Length, che ha la funzione di restituire il numero di documenti aperti.
Metodi dell'oggetto History
I metodi dell'oggetto history servono per spostarsi avanti e indietro nella cronologia.
- Back n
Sposta indietro di n pagine il puntatore di pagina. - Forward n
Sposta avanti di n pagine il puntatore di pagina. - Go n
Sposta all'n-esimo elemento della cronologia.
L'oggetto Location
È un oggetto contenuto nell'oggetto window ed è responsabile della memorizzazione dell'Url corrente. Se la finestra del browser contiene dei frame, ogni frame ha il suo oggetto location.
Le proprietà dell'oggetto Location
Forniscono L'Url completo o uno dei suoi componenti. Modificando queste proprietà si comanda al browser di aprire una nuova pagina:
- Href: Restituisce o imposta l'url della pagina
- Protocol: Restituisce o imposta il protocollo della pagina corrente (http, ftp ...)
- Host: Restituisce o imposta l'host e la porta dell'url corrente.
- Hostname: Restituisce o imposta il nome del host.
- Port: Restituisce o imposta il numero della porta.
Un esempio pratico:
<html>
<body>
<script language="vbscript">
Sub cmdBtn_OnClick
Window.location.href="pro.html.it"
End Sub
</script>
<h1>Pagina dell'Oggetto Location</h1>
<input type="Button" name=" cmdBtn" value="Clicca qui">
</body>
</html>
L'oggetto Navigator
Anch'esso è un oggetto contenuto all'interno dell'oggetto Window e presenta le informazioni relative al browser.
Le proprietà dell'oggetto Navigator
- appCodeName: Restituisce il nome in codice del browser (es: Mozilla)
- appName: restituisce il nome dell'applicazione del browser (es:Microsoft Internet Explorer)
- appVersion: restituisce la versione del browser
- userAgent: restituisce la stringa inviata dal browser al server nell'intestazione della richiesta http
L'oggetto Document
Ogni finestra o frame può contenere solo un'oggetto Document, che contiene al suo interno i seguenti oggetti:
- Link
- Anchor
- Form
Proprietà dell'oggetto Document
- Links: restituisce una matrice di collegamenti contenuti nell'oggetto Document.
- Anchors: Restituisce una matrice di ancore definite con il tag <a> nel documento.
- Form: restituisce una matrice che contiene tutti i form del documento.
- LinkColor: imposta o restituisce il colore usato per visualizzare un collegamento ipertestuale.
- aLinkColor: imposta o restituisce il colore usato per visualizzare un collegamento ipertestuale attivo
- vlinkColor: imposta o restituisce il colore usato per visualizzare i collegamenti ipertestuali visitati.
- BgColor: permette di leggere il colore di sfondo.
- FgColor: permette di leggere il colore del testo in primo piano.
I metodi dell'oggetto Document
Si concentrano sulla modifica o la creazione di documenti durante l'esecuzione.
- Write: permette di visualizzare sullo schermo il testo tra virgolette. Esempio:
document.write "Hello World"
- Writeln: permette di visualizzare su schermo una stringa su schermo, differisce dal metodo write solo nel fatto che dopo aver scritto la stringa aggiunge una linea vuota.
- Close: chiude la finestra del browser.
L'oggetto Link
È uno degli oggetti contenuti in Document e rappresenta una matrice di collegamenti del documento. Un link è un tag <a> che contiene un attributo HREF.
Proprietà dell'oggetto Link
- Length: Rappresenta il numero di collegamenti contenuti nel documento corrente.
- Href: Permette di modificare o leggere l'url del link.
- Protocol: restituisce il protocollo del documento corrente.
- Host: restituisce una stringa contenente l'host e la porta.
- HostName: restituissce il nome dell'host.
L'oggetto Anchor
È uno degli oggetti contenuti in Document e rappresenta una matrice che contiene le ancore contenute nel documento corrente, le ancore sono rappresentate dal tag <a> senza attributo href.
Proprietà dell'oggetto anchor
- name: restituisce una stringa che contiene il nome del tag <a> ed è una proprietà di sola lettura.
- lenght: Restituisce il numero degli elementi presenti nella matrice.
L'oggetto Form
È contenuto nell'oggetto Document e anch'esso è rappresentato dalla una matrice di form contenuti nel documento corrente.
Proprietà dell'oggetto Form
- action: Corrisponde all'attributo action del form (<form action="index.asp">) contiene l'url dell'applicazione.
- Encoding: usando questa proprietà si può settare il tipo mime del form(corrisponde all'attributo enctype)
- Method: è una proprietà che corrisponde al tag Method e come esso può assumere i seguenti valori: post e get.
