WML-Tutorial
[ Inhaltsverzeichnis ]WMLScript
 WMLBrowser-Bibliothek
Grundlagen der WMLBrowser-Bibliothek
getVar(...)
getCurrentCard(...)
go(...)
newContext(...)
prev(...)
refresh(...)
setVar(...)


Grundlagen der WMLBrowser-Bibliothek

Die WMLBrowser-Bibliothek enthält Funktionen, mit denen auf den WML-Browser-Context zugegriffen werden kann.


getVar(...)

Die Funktion getVar(...) liefert den Inhalt der Variablen Varname im aktuellen WML-Browser-Context. Ist die Variable Varname nicht im aktuellen WML-Browser-Context enthalten, so ist der Rückgabewert dieser Funktion ein leeren String.

Funktionskopf 

 : 

 getVar(Varname)

 

 

 

Parameter 

 : 

 Varname

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Erklärung :

Angenommen im aktuellen WML-Browser-Context wäre die Variable 'plz' auf 33602 gesetzt, so würde der Variablen 'x ' im WMLScript dieser Wert zugewiesen.

Beispiel :


var x = WMLBrowser.getVar("plz"); // --> x = 33602

getCurrentCard(...)

Die Funktion getCurrentCard(...) gibt die kleinste relative URL der WML-Card zurück, die aktuell vom WML-Browser verwendet wird. Sollte das Deck der WML-Card ausserhalb der Basis-URL des WMLScripts liegen, so gibt diese Funktion eine absolute URL zurück.

Funktionskopf 

 : 

 getCurrentCard()

 

 

 

Parameter 

 : 

 

 

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Erklärung :

Angenommen das WMLScript und die WML-Card im Deck haben die selbe Basis-URL. Weiterhin angenommen, daß das WML-Deck den Namen 'test.wml' und die WML-Card in diesem WML-Deck die id mit dem Wert 'index' hat. Dann würde der Variablen x im unten stehenden Beispiel der Wert 'test.wml#index' zugewiesen werden.

Beispiel :


var x = WMLBrowser.getCurrentCard();

go(...)

Die Funktion go(...) ruft die ihr übergebene Url auf, nachdem das WMLScript beendet ist.
Die Funktionen prev(...) und go(...) überschreiben die Navigation, die nach dem Ende des WMLScripts ausgeführt wird. Es wird nur die Navigation des zuletzt gemacht Aufrufs durchgeführt.

Funktionskopf 

 : 

 go(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 leere Zeichenkette oder invalid

Beispiel :


WMLBrowser.go("http://wap.ffh.de");

newContext(...)

Die Funktion newContext(...) löscht alle Werte der im aktuellen WML-Browser-Context vorhandenen Variablen. Weiterhin wird auch die WML-Browser-History gelöscht. Ausgenommen davon ist die aktuelle Card, die das WMLScript aufgerufen hat, die Funktion newContext(...)durchzuführen. Deren Context wird nach der Rückkehr in den WML-Browser gelöscht.

Funktionskopf 

 : 

 newcontext()

 

 

 

Parameter 

 : 

 

 

 

 

 

Rückgabewert 

 : 

 leere Zeichenkette oder invalid

Beispiel :


WMLBrowser.newContext();

prev(...)

Die Funktion prev(...) veranlasst den WML-Browser auf die vorherige Seite zu gehen. Diese Navigation erfolgt erst nachdem das WMLScript beendet ist.
Die Funktionen prev(...) und go(...) überschreiben die Navigation, die nach dem Ende des WMLScripts ausgeführt wird. Es wird nur die Navigation des zuletzt gemacht Aufrufs durchgeführt.

Funktionskopf 

 : 

 prev()

 

 

 

Parameter 

 : 

 

 

 

 

 

Rückgabewert 

 : 

 leere Zeichenkette oder invalid

Beispiel :


WMLBrowser.prev();

refresh(...)

Die Funktion refresh(...) bewirkt eine sofortige Aktualisierung des WML-Browser-Contextes. Wird das sofortige Aktualisieren nicht unterstützt, so wird invalid zurückgegeben ansonsten eine leere Zeichenkette oder eine Zeichenkette mit einer Fehlermeldung, falls ein Teilaktualisierung nicht erfolgreich war.

Funktionskopf 

 : 

 refresh()

 

 

 

Parameter 

 : 

 

 

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


WMLBrowser.refresh();

setVar(...)

Die Funktion setVar(...) setzt den Inhalt der Variable mit dem Namen Varname im aktuellen WML-Browser-Context auf den angegebenen Wert. Wurde dieser Wert der Variablen Varname erfolgreich gesetzt, so gibt die Funktion true zurück, andernfalls false.

Funktionskopf 

 : 

 setvar(Varname,Wert)

 

 

 

Parameter 

 : 

 Varname

 Zeichenkette

 Wert

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 true,false oder invalid

Erklärung :

Angenommen im aktuellen WML-Browser-Context gäbe es die Variable 'plz', so würde der Wert der Variable 'plz' im WML-Brower-Context auf '33602' gesetzt. Der Variable 'x' im WMLScript würde somit true zugewiesen werden, da die Zuweisung erfolgreich war.

Beispiel :


var x = WMLBrowser.setVar("plz","33602");