mobileViewer.initialize(options)
Lo spazio dei nomi mobileViewer contiene tutte le classi del framework e fornisce inoltre numerosi metodi globali per gestire funzioni quali la creazione di sessioni, il caricamento di script, la creazione dinamica di elementi HTML e l'invio di richieste AJAX.
Metodi
È consigliabile chiamare il metodo mobileViewer.initialize(options) prima di utilizzare le classi all'interno del framework.
Sono supportate le opzioni seguenti:
|
mgURL |
URL per il Map Agent di Infrastructure Map Server, ad esempio: "../mapagent/mapagent.fcgi" |
|
googleAPIKey |
Chiave API da utilizzare per il caricamento dell'API di Google Maps™ al fine di includere i layer base di Google nella Carta. |
|
yahooAPIKey |
Chiave API da utilizzare per il caricamento dell'API di Yahoo Maps |
|
bingAPI |
Valore booleano utilizzato per indicare se è necessario caricare l'API di Bing. Non è necessaria una chiave specifica. |
|
onComplete |
Metodo di callback da richiamare al completamento dell'inizializzazione. |
Per un esempio di utilizzo di tale metodo, osservare il metodo initializeMobileViewer() nella pagina index.html del framework.
Restituisce la stringa localizzata corrispondente al valore di chiave specificato. Le stringhe vengono memorizzate nella cartella localized all'interno di file che utilizzano il formato JSON. Tale formato ne consente il caricamento diretto in JavaScript, eliminando la necessità di eseguire un'analisi file personalizzata.
Invia una richiesta AJAX mediante la classe OpenLayers.Ajax.Request. La classe aggiunge automaticamente un gestore di eccezioni alla richiesta, quindi aggiunge l'URL del framework di base alle richieste specificate senza prefisso "http://".
Per ulteriori informazioni sulle opzioni supportate, vedere la documentazione della classe OpenLayers.Ajax.Request all'indirizzo http://www.openlayers.org
Pratico metodo analogo a mobileViewer.ajaxRequest(), che invia automaticamente la richiesta all'URL del Map Agent di Infrastructure Map Server.
Restituisce il parametro URL corrispondente alla chiave specificata nella richiesta effettuata per il caricamento della pagina principale di mobileViewer.
Converte la stringa XML specificata in formato JSON. L'operazione viene eseguita richiamando uno script PHP e inviando la relativa risposta al metodo di callback fornito.
var newDiv =
mobileViewer.addElement(document.getElementById('mapContainer'),
'div');
Aggiunge contenuto in formato testo all'elemento contenitore HTML specificato. Per Internet Explorer imposta il valore innerText, mentre per altri browser imposta il valore innerHTML.
Aggiunge un listener all'elemento specificato per il nome evento indicato, provocando il richiamo del callback all'attivazione dell'evento. Alcuni browser supportano il metodo addEventListener, mentre altri supportano il metodo attachEvent. Il metodo descritto determina quale dei due metodi utilizzare.
Rimuove un listener di eventi precedentemente aggiunto a mobileViewer.addEventListener.
Visualizza il contenuto HTML specificato in una finestra a comparsa nella parte inferiore della schermata. Il titolo specificato viene visualizzato nella barra del titolo. Il parametro owner viene utilizzato per tenere traccia dell'oggetto responsabile del riquadro a comparsa.
Chiude il riquadro a comparsa attualmente visualizzato. Se viene specificata la proprietà owner facoltativa, il riquadro si chiude solo se l'oggetto owner specificato corrisponde all'oggetto owner del riquadro. In caso contrario, il riquadro si chiude indipendentemente dall'oggetto owner.
Visualizza un messaggio in una casella sullo schermo. Se si specifica il parametro duration facoltativo (un valore espresso in millisecondi), il messaggio viene nascosto automaticamente una volta trascorso tale intervallo di tempo.
Chiude un messaggio a comparsa. Risulta particolarmente utile se popupMessage è stato chiamato senza specificare una durata.