DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> WEB網站前端 >> 關於網頁技巧
WML Script 函式庫:URL 與 Dialogs 篇
編輯:關於網頁技巧     

WMLScript 把可重複使用的功能切成若干函式庫(libraries),每個函式庫對應一組任務。以下整理 URL 與 Dialogs 兩個實用函式庫。

6.5 URL 函式庫

用於處理絕對與相對 URL。URL 的一般語法為:

scheme://host:port/path;parameters?query#fragment

這組函式的共同特性:絕對與相對 URL 都支援;相對 URL 不會被自動轉為絕對 URL;參數 url 一律為字串;遇到不合法的 URL 語法時回傳 invalid。

isValid(url)

檢查給定的 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

getScheme(url) / getHost(url) / getPort(url) / getPath(url)

分別取出 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 同樣回傳空字串。

getParameters(url) / getQuery(url) / getFragment(url)

分別取出分號後的參數段、問號後的查詢段與井號後的片段;未指定時回傳空字串。

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() / getReferer()

兩者都不需要參數。getBase() 回傳目前 WMLScript 程式的絕對 URL(不含 fragment);getReferer() 回傳呼叫目前程式的那個資源之相對 URL(相對於目前程式的基本 URL)。注意內部函式呼叫不會改變參照者,若目前程式沒有參照者則回傳空字串。

var base = URL.getBase();      // "https://www.acme.com/current.scr"
var ref  = URL.getReferer();   // "app.wml"

resolve(baseUrl, embeddedUrl)

依 RFC 2396 的規則,把相對的 embeddedUrl 依 baseUrl 解析為絕對 URL。

var a = URL.resolve("https://www.foo.com/", "foo.vcf");
// a = "https://www.foo.com/foo.vcf"

escapeString(string) / unescapeString(string)

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"

loadString(url, contentType)

載入給定的絕對 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");

6.7 Dialogs 函式庫

提供典型的用戶介面互動,共三個函式。

prompt(message, defaultInput)

顯示訊息與輸入提示,defaultInput 為輸入框的初始內容,回傳使用者輸入的字串。

var a = "09-555 3456";
var b = Dialogs.prompt("Phone number", a);

confirm(message, ok, cancel)

顯示訊息與兩個選項,等待使用者選擇;選 ok 回傳 true,選 cancel 回傳 false。

function onAbort() {
  return Dialogs.confirm("Are you sure?", "Yes", "No");
}

alert(message)

顯示訊息,等待使用者按確定,回傳空字串。常用於輸入驗證:

function testValue(textElement) {
  if (String.length(textElement) > 8) {
    Dialogs.alert("Enter name < 8 chars!");
  }
}

6.8 函式庫總覽

WMLScript 1.1 共定義六個標準函式庫:

  • Lang:Abs、Min、Max、ParseInt、ParseFloat、IsInt、IsFloat、MaxInt、MinInt、Float、Exit、Abort、Random、Seed、CharacterSet
  • Float:Int、Floor、Ceil、Pow、Round、Sqrt、MaxFloat、MinFloat
  • String:Length、IsEmpty、CharAt、SubString、Find、Replace、Elements、ElementAt、RemoveAt、ReplaceAt、InsertAt、Squeeze、Trim、Compare、ToString、format
  • URL:IsValid、GetScheme、GetHost、GetPort、GetPath、GetParameters、GetQuery、GetFragment、GetBase、GetReferer、Resolve、EscapeString、UnescapeString、LoadString
  • WMLBrowser:GetVar、SetVar、Go、Prev、NewContext、GetCurrentCard、Refresh
  • Dialogs:Prompt、Confirm、Alert

其中 WMLBrowser 值得多說一句,它是 WMLScript 與頁面導航之間的橋樑:GetVar/SetVar 讀寫 WML 變數,Go 跳到指定 URL 或卡片,Prev 相當於返回上一張卡片,NewContext 重設瀏覽器前後關聯狀態,GetCurrentCard 取得當前卡片識別,Refresh 重新載入。這組介面讓「驗證輸入後才允許進入下一頁」這類流程得以在用戶端完成,省去一趟伺服器往返——這正是窄頻環境下最寶貴的優化。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved