WMLScript 把可重複使用的功能切成若干函式庫(libraries),每個函式庫對應一組任務。以下整理 URL 與 Dialogs 兩個實用函式庫。
用於處理絕對與相對 URL。URL 的一般語法為:
scheme://host:port/path;parameters?query#fragment
這組函式的共同特性:絕對與相對 URL 都支援;相對 URL 不會被自動轉為絕對 URL;參數 url 一律為字串;遇到不合法的 URL 語法時回傳 invalid。
檢查給定的 url 是否符合 URL 語法,是則回傳 true。
var a = URL.isValid("https://www.acme.com/script#func()"); // a = true
var b = URL.isValid("../common#test()"); // b = true
var c = URL.isValid("experimental?://www.acme.com/pub"); // c = false
分別取出 URL 的協議、主機、連接埠與路徑部分,回傳字串。
var a = URL.getScheme("https://w.a.com"); // a = "http"
var b = URL.getScheme("w.a.com"); // b = ""
var c = URL.getHost("https://www.acom.com/pub"); // c = "www.acom.com"
var d = URL.getPort("https://www.acom.com:80/path"); // d = "80"
var e = URL.getPath("https://w.a.com/home/sub/comp#frag"); // e = "/home/sub/comp"
若 port 未指定,getPort 回傳空字串;相對 URL 的 host 同樣回傳空字串。
分別取出分號後的參數段、問號後的查詢段與井號後的片段;未指定時回傳空字串。
var a = URL.getParameters("https://w.a.c/scr;3;2?x=1&y=3"); // a = "3;2"
var b = URL.getQuery("https://w.a.c/scr;3;2?x=1&y=3"); // b = "x=1&y=3"
var c = URL.getFragment("https://www.acom.com/cont#fray"); // c = "fray"
兩者都不需要參數。getBase() 回傳目前 WMLScript 程式的絕對 URL(不含 fragment);getReferer() 回傳呼叫目前程式的那個資源之相對 URL(相對於目前程式的基本 URL)。注意內部函式呼叫不會改變參照者,若目前程式沒有參照者則回傳空字串。
var base = URL.getBase(); // "https://www.acme.com/current.scr" var ref = URL.getReferer(); // "app.wml"
依 RFC 2396 的規則,把相對的 embeddedUrl 依 baseUrl 解析為絕對 URL。
var a = URL.resolve("https://www.foo.com/", "foo.vcf");
// a = "https://www.foo.com/foo.vcf"
escapeString 把字串中的特殊字元換成 %xx 形式的十六進位轉義序列,需轉義的包括:控制字元(ASCII 00–1F 與 7F)、空格(20)、保留字元(; / ? : @ = + $ ,)、不建議使用的字元({ } | \ ^ [ ] `)與分隔符(< > # %)。若字串本來已是轉義形式,則不會再解析。字串含非 ASCII 字元時回傳 invalid。
var a = URL.escapeString("https://w.a.c/dck?x=12#crd");
// a = "http%3a2f%2fw.a.c%2fdck%3fx%3def%23crd"
var b = URL.unescapeString(a); // 反向還原
// b = "https://w.a.c/dck?x=12#crd"
載入給定的絕對 URL 內容並以字串回傳。content type 必須符合幾項規則:只能指定一種格式、整個字串須與該格式相符、前後不得有多餘空白;格式必須是文字(text/)開頭。載入成功且內容格式相符時,內容被轉為字串回傳;載入失敗時回傳與所用 URL scheme 相關的錯誤碼(若走 HTTP 或 WSP,回傳 HTTP 錯誤碼);contentType 錯誤則回傳 invalid。
var myUrl = "https://www.acme.com/vcards/myaddr.vcf"; myCard = URL.loadString(myUrl, "text/x-vcard");
提供典型的用戶介面互動,共三個函式。
顯示訊息與輸入提示,defaultInput 為輸入框的初始內容,回傳使用者輸入的字串。
var a = "09-555 3456";
var b = Dialogs.prompt("Phone number", a);
顯示訊息與兩個選項,等待使用者選擇;選 ok 回傳 true,選 cancel 回傳 false。
function onAbort() {
return Dialogs.confirm("Are you sure?", "Yes", "No");
}
顯示訊息,等待使用者按確定,回傳空字串。常用於輸入驗證:
function testValue(textElement) {
if (String.length(textElement) > 8) {
Dialogs.alert("Enter name < 8 chars!");
}
}
WMLScript 1.1 共定義六個標準函式庫:
其中 WMLBrowser 值得多說一句,它是 WMLScript 與頁面導航之間的橋樑:GetVar/SetVar 讀寫 WML 變數,Go 跳到指定 URL 或卡片,Prev 相當於返回上一張卡片,NewContext 重設瀏覽器前後關聯狀態,GetCurrentCard 取得當前卡片識別,Refresh 重新載入。這組介面讓「驗證輸入後才允許進入下一頁」這類流程得以在用戶端完成,省去一趟伺服器往返——這正是窄頻環境下最寶貴的優化。