WAP开发入门与提高之WML浏览器函数库 Dialog函数库

转自：http://bbs.xml.org.cn/dispbbs.asp?boardID=77&ID=59088


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!");
};
};