[ Inhaltsverzeichnis ] | WMLScript |
WMLBrowser-Bibliothek |
Grundlagen der WMLBrowser-Bibliothek getVar(...) getCurrentCard(...) go(...) newContext(...) prev(...) refresh(...) setVar(...) |
Grundlagen der WMLBrowser-BibliothekDie WMLBrowser-Bibliothek enthält Funktionen, mit denen auf den WML-Browser-Context zugegriffen werden kann. |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
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.
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 |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
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.
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(); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
go(...)
Die Funktion go(...) ruft die ihr übergebene Url auf, nachdem das WMLScript beendet ist.
Beispiel : |
|||||||||||||||||||
WMLBrowser.go("http://wap.ffh.de"); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||
WMLBrowser.newContext(); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
prev(...)
Die Funktion prev(...) veranlasst den WML-Browser auf die vorherige Seite zu gehen. Diese Navigation erfolgt
erst nachdem das WMLScript beendet ist.
Beispiel : |
|||||||||||||||||||
WMLBrowser.prev(); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
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.
Beispiel : |
|||||||||||||||||||
WMLBrowser.refresh(); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
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.
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"); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
© 2001 Ralf Peter Korte |