WAP開發入門與提高之WML浏覽器函數庫 Dialog函數庫

轉自：[url]http://bbs.xml.org.cn/dispbbs.asp?boardID=77&ID=59088[/url]

6.6 WML浏覽器函數庫

名稱：WML Brower

說明:這個函數庫所包含的程式是讓WML Script用來存取與WML相關的内文，這些程式不能有任何的副作用，并在下列的狀況下回傳

invalid值。

系統不支援WML浏覽器。

WML浏覽器無法使用WML Script解譯器。

getVar

程式：getVar(name)

說明：回傳目前浏覽器内文的所給予名稱name的變量值。

如果所指定的變量不存在，回傳一個空字元串。

變量名稱必須依照WML文法來使用。

參數：name=字元串

回傳值：字元串或invalid

例外狀況：如果變量名稱不合文法，則回傳invalid

範例：var a=WMLBrowser.getVar("name");

// a"Jon"或者變量的值

setVar

程式：setVar(name,value)

說明：在目前的浏覽器之中，如果所給予名稱name的變量，它的值同給予的值value設定的一樣的話，回傳ture，否則回傳false。

變量名稱必須依照WML文法來使用。

變量值必須是合法的XML CD ATA

參數：name=字元串

value=字元串

回傳值：布爾值或invalid

例外狀況：如果變量名稱或它的值不合文法，則回傳invalid

範例：var a=WMLBrowser.setVar("name",Mary); // a=true

go

程式：go(url)

說明：将給予的url所标記的内文載入，這個程式予WML的GO動作意思相同。

如果所給予的url字空字元串（""），則不會載入任何内文。

go()與prev（）函數庫程式會互相推翻，在回傳控制與WML浏覽之前都可以加以調用多次。

隻有最後的調用設定的會保持作用，如果最後的調用為go()或prev（）,其所設定的url為空字元串（""），所有的要求都會被取消

。

這個程式回傳空字元串。

參數：url=字元串

回傳值：字元串或invalid

例外狀況：無

範例:varcard="http://www.acme.com/loc/app.dck#start";WMLBrowser.go(card

)

prev

程式：prev()

說明:告訴WML浏覽器回到先前的WML Card，這個程式的功能與WML中的prev動作一樣。

go()與prev()函數庫程式會互相推翻，在回傳控制與WML 浏覽之前都可以加以調用多次。

隻有最後的調用設定是會保持作用，如果最後的調用為go()或prew(),其所設定的url為空字元串（""），所有的要求都會被取消。

這個程式回傳空字元串。

參數：無

回傳值：字元串或invalid

例外狀況：無

範例：WMLBrowser.prev();

newContext

程式：newContext()

說明：将目前WML浏覽器的内文清除并回傳一個空字元串，這個程式的公用與WML的NEWCONTEXT屬性一樣。

參數：無

回傳值：字元串或invalid

例外狀況：無

範例：WMLBrowser.newContext（）；

getCurrentCard

程式：getCurrentCard()

說明：回傳目前WML浏覽器所處理card的最小相關URL，如果WML deck所包含目前程式的基本位址不同的話，則此程式會回傳絕對URL

。

參數：無

回傳值：字元串或invalid

例外狀況：如果沒有目前的card，則回傳invalid。

範例：var a=WMLBrowser.getCurrentCard();// a="deck#input"

refresh

程式：refresh()

說明：強制WML浏覽器更新它的内文并回傳一個空字元串，而使用者界面會加以更新以反應更新後的内容，這個程式與WML中的refresh

功能一樣。

參數：無

回傳值：字元串或invalid

例外狀況：無

範例：WMLBrowser.setVar("name","Zorro");

WMLBrowser.refresh();

6.7 Dialog函數庫

名稱：對話

說明：這個函數庫包含典型的使用者界面程式。

prompt

程式：prompt(message,defaultInput)

說明：顯示給予的資訊message與使用者輸入的提示符号，defaultInput參數包含了使用者輸入所需的初始内文，回傳使用者輸入。

參數：message=字元串

defaultInput=字元串

回傳值：字元串或invalid

例外狀況：無

範例：var a="09-555 3456"; var b=Dialogs.prompt("Phome number";a);

confirm

程式：confirm(message,ok,cancel)

說明：顯示所給予的資訊message與兩個選項：ok與cancel,等待使用者選取其中一個，如果是ok則回傳false。

參數：message=字元串

ok=字元串

cancel=字元串

回傳值：布爾值invalid

例外狀況：無

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

alert

程式：alert(message)

說明：顯示所給予的資訊message給使用者，等待使用者确定并回傳一個空字元串。

參數：message=字元串

回傳值：字元串或invalid

例外狀況：無

範例：function testValue(textElement){

if (String.length(textElement)＞8) {

Dialogs.alert("Enter name ＜8 chars!");

};

};