独上高楼网站
  •    你所在位置:首页 VS.netXMLWML〉WML语法大全
  • WML语法大全
  • 作者:佚名  文章来源:http://homepage.yesky.com/  发布日期:2008-03-04  浏览次数:179
  • 打印这篇文章
  •  

    WML语法大全

    WML是一种基于XML(扩展标记语言)的一种标记语言。这种语言是为无线设备用户提供交互界面而设计的。这些无线设备包括电话、呼机和个人数字助理(Personal Digital Assistants)等等。
    WML是为具有以下特点的设备而设计的:
    体积小(相对于个人计算机)。
    有限的内存和CPU大小。
    通讯带宽窄和时延长。

    现在支持WML的设备大致分为两大类:
    电话 其特点就是只有4~10行的文本屏幕。用户通过电话的按钮进行输入。
    个人数字助理(PDA)其特点就是能支持100×100分辨率(或者更好)。用户能够通过键盘、鼠标或者手写输入。
    现在正期待着其他的手持设备同样能支持WML。

    因为WML支持许多功能不同的设备,因此文档中列出了这些设备至少应有的功能或者是参考设备。参考设备有以下的特点:
    有一个显示屏幕,能显示4行字符,每行12个字符。包括保留给功能按钮的那一行。
    支持ASCII的可打印码。
    支持数字和字符的输入。
    支持使用箭头或者数字按钮进行选择。
    两个可编程功能键,ACCEPT和OPTIONS,并且显示在接近键盘的屏幕下。
    一个PREV导航键。
    支持垂直滚动的箭头按键。
    支持水平滚动(不是使用自动换行)。
    --------------------------------------------------------------------------------

    字符集 WML使用XML的字符集?也就是当前使用的通用的字符集ISO/IEC-10646(Unicode 2.0)并且支持其他系列的子集(例如:US-ASCII、ISO-8859-1或者UTF-8)。不必使用整个Unicode(UCS-4)编码,除非正在使用的不是UTF-8编码。

    大小写敏感 不象HTML,WML是一种大小写敏感的语言。所有的标签、属性和枚举属性都必须使用小写。在编写WML页面的时候,必须注意到大小写。包括参数的名字和参数的数值都是大小写敏感的。例如:variable1、Variable1和vaRiable1都是不同的参数。

    不显示的字符 表3-2中包括了在WML中不显示的字符:

    表 3-2 不显示的字符
    字符     8位十进制值
    换行     10
    回车     13
    空格     32
    水平制表符  9

    除非特别的指定,WML将一个或多个连续的换行、回车、水平制表和空格转换成一个空格。换句话说,忽略所有的多于一个以上的不显示字符。
    例子1:< wml>< card>< p>Some text< /p>< /card>< /wml>
    例子2:< wml>
        < card>  
          < p>
            Some text  
          < /p>
        < /card>
    < /wml> 
    上面的例子中,手工地使用换行和回车保证程序的可读性,但不是很必要。

    文件开场白 所有的WML页面必须在文件的开头处声明XML文件类型:

    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"  "http://www.wapforum.org/DTD/wml_1.1.xml">
    为了将这个开场白自动地加入到页面中,读者可以使用函数调用来实现。
    注意:为了确定WAP浏览器的类型和版本,可以通过捕获HTTP头中的USER_AGENT来进行。
      Content Type 为了建立一个有效的WML信息实体(MIME type),必须在文件的开场白之前指定文件的类型:
    Content-type: text/vnd.wap.wml
    注意:必须(至少)在Content Type和XML文件声明之前保留一段空行。如果省略,将造成编译器错误。过多空行同样会造成错误。

    属性 许多WML标记有一个或多个属性标记,有些是必须的,有些是可选择的。属性可以指定附加的信息,用来确定设备如何解释这些标签。WML标记有以下两种使用方式:
    < element a1="value1" a2="value2" ...> content < /element>
    < element a1="value1" a2="value2" .../>
    必须使用成对的单引号或者双引号将属性值包含在内,每个属性之间使用空格分开。

    引用变量 很像UNIX下的Shell变量,可以在格式化的文本、URL、选择文本等等文本内容中使用变量。
    使用变量的语法如下:$(myvar)。

    特殊字符 WML的保留字符:“< ”、“>”、“'”、“"”和“&”。为了在文本中显示这些字符,必须按照表3-3中规定的方式指定。

    表 3-3 指定特殊字符
    字符       指定方式
    <           <
    >          >
    ‘          '
    "          "
    &          &
    $          $$
    连续空格        
    -          -

    分号是字符标签的一个部分,不能省略。如果省略了,将可能会造成WML编译器错误。
    注意:与HTML不同的是,当在URL中使用&的时候必须使用&来代替字符&。

    WML使用XML文档字符集,目前支持Unicode 2.0。与HTML不同,WML的所有标签、属性和规定的枚举值必须小写。卡片的名字和变量也是区分大小写。和HTML一样,对于连续的空字符,只显示一个空格。标签内属性的值必须用双引号或者单引号括起来。属性名、等号和值之间不能有空格。对于不成对出现的标签,必须在“>”前加“/”。比如:< br/>。在对变量的引用上和HTML基本相同,有以下三种形式:

    $(var1:esc)
    $(var1:noesc)
    $(var1:unesc)
    三种形式,具体含义可参见HTML的相关部分。在对保留字符的处理上也基本相同,对应的替代字符请详见“字符实体”。这里要指出的是在URL的传递过程中,用来连接参数的&必须转化为&。

    wml文件的一般格式:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
        < head>
            < access/>
            < meta..../>
        < /head>
        < card>
            Some contents...
        < /card>
    < wml>
    结构看上去和HTML文件很类似,对于每一个页面,在其文档开头必须指明以下的类型声明:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">

    千万注意字母的大小写。对于一个页面,其文件大小最好不要超过1.2K。
    < wml>标签和HTML中的< html>标签一样,用来表明这是一个WML的页面。它有一个可选的“xml:lang”属性来制定文档的语言,比如< wml xml:lang="zh">表示文档语言为中文。
    和HTML一样< head>标签包含了该页面的相关信息。< head>标签之间可以包含一个< access>标签和多个< meta>标签。
    < access domain="域" path="/路径" />相当于HTML中的< BASE>标签,指定该页面的访问控制信息。它用两个可选的属性,domain用来指定域,默认值为当前域;path用来指定路径,默认值为“/”,即根目录。由于< access>单独使用,所以要用“/”结尾,以后对于类似的情况不再赘述。
    < meta 属性 content="值" scheme="格式" forua="true|false"/>和HTML中的类似,提供了该页面的meta信息。属性是必选的,包括以下三种情况:
     name="name" UP.Link Server忽略meta数据。
     http-equiv="name" UP.Link Server将meta数据转为HTTP响应头(同HTML)。
     user-agent="agent" UP.Link Server直接将meta数据传给手机设备。
    content属性也是必选的,其内容根据属性而定。scheme属性目前尚不支持。forua为可选属性,指定在该wml文件传到客户端之前,< meta>标签是不是被中间代理删除(因为传输的协议可能改变),默认值为false。

    目前支持的meta数据:
    < meta http-equiv="Cache-Control" content="max-age=3600"/>
    指定页面在手机内存缓存中的存储时间段,默认的为30天(除非内存耗尽)。在此期间,手机对于访问过的页面直接从缓存里调用。如果信息是对时间敏感的,可以用max-age指定页面在缓存里的生存期,最小单位是秒。如果指定为0,则每次都需通过连接服务器来调用该页面
    < meta user-agent="vnd.up.markable" content="false"/>
    < meta user-agent="vnd.up.bookmark" content="指定的URL"/>
    类似于普通浏览器的书签功能。当用户将一个卡片做了书签后,手机浏览器首先用一个标记记录该卡片。这个标记默认的是< card>标签中的title属性(以后会讲到)。然后当用户选择了该书签以后,浏览器就会打开被记录的URL。但是因为在默认的情况下,手机会记录所有的页面。所以,一般< meta>被用来使手机不要记录当前的URL,即< meta user-agent="vnd.up.markable" content="false"/>。此外,如果要为书签指定不同于当前页面的URL,用< meta user-agent="vnd.up.bookmark" content="指定的URL"/>。
    一个页面可以包含多个卡片,每个卡片的内容可能不止一屏显示,注意页面、卡片和屏幕显示范围的关系。一个卡片用< card>和< /card>包含。< card>可以包含以下可选的属性:
    < card id="name" title="label" newcontext="false" ordered="true" onenterforward="url" onenterbackward="url" ontimer="url">
     id属性用来指定卡片的名字,可用来在卡片间跳转,相当于在HTML中在页内跳转时用< A NAME="jumpHere">。
     title属性用来作为书签的标记,该属性一般不会显示在屏幕上。
     newcontext属性(默认值为false)用来指示当跳转到本卡片时,手机是不是要清除以前保留的信息。包括变量、堆栈里的历史记录、重新设置手机状态等。
     ordered属性(默认值是true)表明该卡片里的内容是按固定的顺序显示,还是按用户的选择顺序来显示。这点和HTML不同,卡片里的内容可以按一定的顺序显示。默认的是按线性顺序显示,即按代码的顺序。但是,要注意的是,以下三个标签必须按以下顺序来写:< onevent>、< timer>、< do>(这和以后要讲的“事件”有关)。这样做是为了方便填表单,当ordered设置为true时,如果一个表单的内容不能在一屏里显示完,就分成多屏显示;当ordered设置为false时,手机可以显示一个概要卡片来总结有效的选项,用户可以从中选取表单选项来填写。
     onXXXX属性,类似于HTML标签中的onXXXX属性,用来捕捉事件。当事件被触发时执行指定的操作(任务),在这里是转向某个URL。

    在文本的显示上WML基本和HTML相同。文字段落包含在< p align="alignment" mode="wrapmode">和< /p>之间。align属性指定该段文字的对齐方式,默认的是left。其他可选择right和center;mode属性指定当一行显示不下所有的文字时是否自动换行。默认的是自动换行wrap。如果选nowrap,则在一行中显示,浏览器会通过类似于水平滚动条的机制来显示所有文字。
    换行标签也一样为< br/>。这里先提一下,在表单中如果有多个< input>或者< select>,其间不要用< br/>,否则会使手机浏览器认为是断点而把表单分页显示。
    文字的修饰标签有< b>、< i>、< u>、< em>、< strong>、< big>和< small>,意义和HTML里的相同。
    表格的显示标签也和HTML相近,使用< table title="name" align="left|right|center" columns="列数">、< tr>和< td>来显示。< table>的title属性用来给表格取个名字,columns属性指定表的列数,不能为0。可选的align属性和前面提到的一样是对齐方式。表格中可以包含文字和图片。
    请看下面的例子:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
    "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
        < card>
            < p align="center">
                < i>Hello< /i>
                < b>< i>World!< /i>< /b>
                < table title="mytable" align="right" columns="2">
                    < tr>
                        < td>1-1< /td>
                        < td>1-2< /td>
                    < /tr>
                    < tr>
                        < td>2-1< /td>
                        < td>2-2< /td>
                    < /tr>
                < /table>
            < /p>
        < /card>
    < /wml>

    显示图片(1位黑白BMP图片)的标签一样类似于HTML。
    < img alt="text" src="url" localsrc="icon" align="left" height="n" width="n" vspace="n" hspace="n"/>
    属性alt和src是必须要有的,其他可选。另外要注意的是< img>要放在< p>里,不能放在< do>和< option>等功能健标签和选单标签里。
    alt属性用来指定当手机不支持图片显示时用来显示的文字。
    src属性指定图片的URL,但当有了以下的localsrc属性时,手机浏览器就忽略src属性。
    localsrc属性用来指定显示存在手机ROM中的图标,如果找不到,则到UP.Link Server上去找。
    可选的align属性用来表明图片同当前行文本的对齐方式,默认值为bottom,可选to和middle。
    height、width、vspace、hspace属性分别指定图片的长宽和距环绕文字的间距,目前不是所有的WAP手机都支持这些属性。
    请看下面的例子程序:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
    "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
        < card>
            < p align="center">< img alt=":)" src="xxx.bmp" localsrc="smileyface"/>< /p>
        < /card>
    < /wml>

    链接是HTML页面里最基本的功能,在WML里也一样用< a href="url" title="label">和< /a>来包括用来建立链接的文字。必选属性href指定了要打开的URL;可选的title属性给该链接取个标记名字,这个名字将作为软按钮之一的ACCEPT键的标记显示在屏幕的软按钮区,所以通常可以将属性作为提示文字使用。
    然而,以上的链接在WML里只是任务的一种情况。为了能够使用其他任务,所以引进了新的标签< anchor title="label">任务标签文本< /anchor>。< a>其实是当任务标签为< go/>时的简单表示方式。

    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
    < card>
        < p>
            < anchor title="Link1">< go href="test1.wml"/>News< /anchor>< br/>
            < a title="Link2" href="test2.wml">Sports< /a>
        < /p>
    < /card>
    < /wml>
    WML里的任务标签有以下几种,除了用于< anchor>,还可以用在事件中:

    < go> 用来指示浏览器显示指定的URL,包括页面的第一个卡片或者指定的卡片。语法如下:
    < go href="url" sendreferer="false|true" method="get|post" accept-charset="charset">
      < postfield name="name" value="value"/>
      < setvar name="name" value="value"/>
    < /go> 
    其中href属性为必选,其他属性为可选。
    sendreferer属性表示是否传递调用href所指定的URL的页面的URL。也就是当前页的URL,即HTTP头中的HTTP_REFERER。默认值为false,可选值为true。
    method和HTML中的表单FORM的method属性一样,指定表单是以get的方式还是post的方式递交,以便CGI处理。默认的值为get,但如果未指定method但< go>与< /go>间存在< postfield>,手机自动以post方式传递。
    accept-charset属性可以覆盖HTTP头里指定的字符集。可以写多个字符集,如accept-charset="UTF-8,US-ASCII, ISO-8859-1"。
    < postfield name="name" value="value"/>可以看作是HTML表单FORM中的< INPUT TYPE="HIDDEN" NAME="变量名" VALUE="值">,通过它可以向指定的URL传递以“变量名/值”形式的数据。name和value属性都是必选的。注意只有这里的变量是用来递交给CGI程序的。
    除了< postfield>,还可以在< go>和< /go>之间加入一句或者多句< setvar name="name" value="value"/>。该语句的意思是,当触发某一事件时,给变量赋值。

    要注意的是:当< go>和< /go>之间没有任何语句时,要用< go/>的形式,这点比较特别。比如:< anchor title="Link1">< go href="test.wml"/>News< /anchor>。

    < prev> 用来将当前页面的URL压入URL历史堆栈,并打开此前的URL。若该URL不存在,则< prev>无效。语法类似< go>:
    < prev>< setvar name="name" value="value"/>< /prev>
     < prev>和< /prev>之间可加入一句或多句< setvar name="name" value="value"/>。若不加,则必须变成< prev/>的形式。

    < refresh> 用来刷新当前的页面,从而使得页面内的变量刷新,语法为:
    < refresh>< setvar name="name" value="value"/>< /refresh>

    < noop> 表示什么也不做。该标签不能用在< anchor>中,一般用在覆盖页面级的事件模板。

    类似于HTML的< FORM>。< fieldset>可用来包括一组表单选项,但不是必须的。前面说过,当< card>的ordered设置为false时,手机可以显示一个概要卡片来总结有效的选项,方便用户从中选取表单选项来填写。概要卡片就是根据< fieldset>和独立的输入框< input>以及选单< select>来总结的。语法为:
    < fieldset title="label">表单内容< /fieldset>
     可选的title属性除了可以用来表示表单的名字外,还在概要卡片里作为选择项的标题。表单内容可以是嵌套的< fieldset>,输入框< input>,选单< select>和必要的提示文本。

    < input name="variable" title="label" type="type" value="value" default="default" format="specifier" emptyok="false|true" size="n" maxlength="n" tabindex="n"/> 用来输入文本,除name属性是必要的,其他可选。
     name属性,指定了用来存储该输入文本的变量名字。
     title属性,该输入框的名字,同样可被用来作为概要card页中的选项名。
     type属性,默认值为text,如选择password,则输入的数据显示为*。
     value属性,在语法和行为上等同于下面的default属性。
     default属性,指定输入框的默认值,即name属性指定变量的默认值,当用户输入新值时,该值无效,如果该值不符合以下format属性的规定,则手机忽略该默认值。
     format属性,用来格式化输入的数据,可用的标记如下,使用时可用“一位数字标记”和“*标记”的形式,前者代表N个标记型字符,如3X,后者代表任意个(小于maxlength属性的值)标记型字符。表3-4中包括了在format中常用的枚举数值及其意义。
     maxlength属性,指定了用户可输入的最大字符长度,最大限制为256个字符。
     emptyok属性,表示用户可否不填输入框,默认为false,即要填。
     size属性,输入框显示长度,目前未被支持。
     tabindex属性,类似于在HTML表单中按TAB键后,焦点落在哪个选项上,该值决定了选择顺序,数字大的排在后面。目前未被支持。

    表 3-4 格式化标记
    标记             描述
    A           任何符号或者大写字母(不包括数字)
    a           任何符号或者小写字母(不包括数字)
    N           任何数字(不包括符号或者字母)
    X           任何符号、数字或者大写字母(不可改变为小写字母)
    x           任何符号、数字或者小写字母(不可改变为大写字母)
    M           任何符号、数字或者大写字母(可改变为小写字母)或者多个字符,默认为首字大写
    m           任何符号、数字或者小写字母(可改变为大写字母)或者多个字符,默认为首字小写

    为了说明输入格式对用户的影响,请看下面的例子程序:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
    "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
    < card id="card1" ordered="false">
      < p>
        USERNAME:< input name="userName" title="User Name" type="text" value="YourNameHere" format="*M" emptyok="false" maxlength="12" tabindex="1"/>
        PASSWORD:< input name="password" title="Password" type="password" format="8x" emptyok="false" maxlength="8" tabindex="2"/>
        COMMENTS:< input name="comments" title="comment" type="text" value="YourCommentsHere" format="*M" emptyok="true" maxlength="30" tabindex="3"/>
      < /p>
    < /card>
    < /wml>

    启动Nokia WAP Toolkit,并选择“Go”下的“Open Location”,在输入URL地址后,可以看到模拟器上出现内容。注意光标默认地指在PASSWORD的编辑框内。
    选择“Options”进行编辑,多按几次按钮。在输入没有满8个之前选择“OK”,模拟器没有任何反应;当超过8个以后就无法再输入。这就是8x的限制在起作用。并且由于PASSWORD输入属性type为“password”因此显示出来的都是“********”。要注意的是:在输入的时候不要太快,否则总在一个字符上切换。如果读者用过手机,应该知道这点。
    在删除所有的字符时候,“Clear”变成了“Back”。模拟器返回以前的页面。
    当编辑“User Name”的时候,发现输入的自动都变成大写。这是因为M起作用。如果输入超过12个字符,那么将无法再输入字符。这是maxlength在起作用。
    当然可以将输入方式切换到小写。
    如果这个时候按“OK”,那么USERNAME就变成了“GJTMW.g”。这是由于M前面是“*”的缘故。它不限制输入字符的数目。但是如果将“User Name”中所有的字符清除,再选择“OK”就不行。这是emptyok在起作用。它要求至少输入一个字符。读者自己试试吧!

    将上例< card>中的ordered的值改为“true”试试看,然后再在< p>和< /p>内加入< fieldset title="field1">和< /fieldset>试试看。(Nokia WAP Toolkit好像对这些变化视而不见……)

    < select>类似于HTML表单中的< SELECT>。< select>和< /select>间可包含< optgroup>和< option>标签,语法如下,所有属性都为可选:
    < select title="label" multiple="false|true" name="variable" default="default" iname="index_var" ivalue="default" tabindex="n">
     < optgroup title="label">选单内容< /optgroup>
     < option title="label" value="value" onpick="url"> 事件或者文本 < /option>
    < /select>
    title属性,如以上< input>的title属性。
    multiple属性,指定用户可否进行多项选择,默认值为false。
    name属性,用来存储用户选择项的变量名,其值为< option>标签的value属性。若用户没有选择又没有用default属性指定默认值,则手机将改变量赋值为空字符串(""),对于多项选择,每个值用“;”分开。
    default属性,可为name属性指定的变量赋成默认值。
    iname属性,用来记录用户选择项的位置,相应的值从1开始。若没选,则该值为0。
    ivalue属性,用来记录默认值所在的位置。
    < optgroup>可用来将多个< option>分组,< optgroup>和< /optgroup>间还可包括< optgroup>和< option>,该标签目前尚未被支持。
    < option>,类似于HTML中选单的< option>,用来表示选单的可选项。< option>和< /option>间可包括事件和选单的显示文本。< option>的属性为可选,其中value属性用来提供值。当选到该项后,将该值赋给< select>的name属性所指定的变量。onpick属性,用来指定用户选到该项并按ACCEPT键后所打开页面的URL。
    为了说明选择项的工作方式,请看下面的例子:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
    "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
        < card id="card0" ordered="false">
        < p>
            Please select a city...
            < select title="Cities List" name="city">
                < option title="Beijing" value="c1">Beijing< /option>
                < option title="Shanghai" value="c2">Shanghai< /option>
                < option title="Hongkong" value="c3">Hongkong< /option>
            < /select>
            Please select columns...
            < select title="Column List" multiple="true" name="col">
                < option title="Hot News" value="l1">News< /option>
                < option title="Cool Sports" value="l2">Sports< /option>
                < option title="Pop Enter,,," value="l3">Entertainment< /option>
            < /select>
        < /p>
    < /card>
    < /wml>

    WML的事件基本上分为两大类,一类是键盘(包括软硬按钮)输入事件,用< do>标签来处理。另一类是相关页面内部的事件,用< onevent>标签来处理。
    < do>的语法如下:
    < do type="type" label="label" name="name" optional="false|true">任务< /do>
    任务就是以前提到的四种任务。< do>的属性中,type是必选的,其他为可选。
    label属性,指定了软按钮在屏幕上的显示文本。目前type属性为delete、help、prev时该属性无效。
    name属性,为< do>取个名字。同一的卡片里的< do>不能重名。如果卡片级的< do>和页面级的< do>同名,则覆盖页面级的< do>。
    optional属性,指定手机是不是可以忽略这个事件,默认值是false。
    type属性,指定触发的事件,具体如表3-5所示:

    表 3-5 type的枚举值
    枚举值            触发原因
    accept            调用ACCEPT按钮机制
    delete            调用DELETE按钮机制
    help             调用HELP按钮机制
    options            调用选择按钮机制
    prev             调用PREV按钮机制
    reset             调用清除和重新设定手机状态时的RESET机制(目前不支持)
    unknown            调用unknown机制。等价于type=""(目前不支持)
    Vnd. co-type         调用厂商特定的机制(目前不支持)
    X-*, x-*           供以后使用(不保留)(目前不支持)

    为了演示事件的触发过程,请看下面的例子:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
    "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
        < head>
            < meta http-equiv="Cache-Control" content="max-age=0"/>
        < /head>
        < card id="card0" ordered="false">
            < do type="accept" label="InputName" name="do1">
                < go href="#card01"/>
            < /do>
            < p>
                NAME:< input name="userName" title="User Name" type="text" format="*M" emptyok="false" maxlength="12"/>
            < /p>
        < /card>
        < card id="card01">
            < p>
                You name is $(userName:noesc).
            < /p>
        < /card>
    < /wml>
    使用Nokia WAP Toolkit对该程序进行测试。启动Nokia WAP Toolkit,并选择“Go”下的“Open Location”。在输入URL地址后,可以看到模拟器上出现的界面。在选择“Optionos”后出现了事件选择项。注意到“InputName”是do标签名字。在选择了“InputName”事件后,模拟器上将出现界面输出姓名

    < onevent>的语法如下:
    < onevent type="type">任务< /onevent>
    必选属性type的取值如表3-6所示:

    表 3-6 type属性的取值
    枚举值        如果用户执行了以下操作就执行任务
    onpick       用户选择或不选一个< option>项时
    onenterforward   用户使用< go>任务到达一个卡片时
    onenterbackward  用户使用< prev>任务返回到前面的卡片时,或者按BACK按钮时
    ontimer      当< timer>过期时

    请看下面的例子程序:

    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
        < head>
            < meta http-equiv="Cache-Control" content="max-age=0"/>
        < /head>
        < card id="card0" ordered="false">
        < p>
            Please select a city...
            < select title="Cities List" name="city">
                < option title="Beijing" value="Beijing">
                < onevent type="onpick">
                    < go href="#card01"/>
                < /onevent>Beijing< /option>
                < option title="Shanghai" value="Shanghai" onpick="#card01">Shanghai< /option>
             < option title="Hongkong" value="Hongkong" onpick="#card01">Hongkong< /option>
            < /select>
        < /p>
        < /card>
        < card id="card01">
            < p>
                You are Living in $(city:noesc)
            < /p>
        < /card>
    < /wml> 

    < timer/>可以用作在用户不进行任何操作的一段时间后,自动执行一个任务,任何激活卡片页面的任务和用户操作都会启动< timer/>,而任务进行时,< timer/>就停止。每个卡片只能有一个< timer/>,一个< timer/>只能触发一个任务。语法如下:
    < timer name="variable" value="value"/>
     其中name为可选属性,指定为一个变量名。当退出该卡片时,该变量存储此时定时器的值。当定时器超时时,手机将该变量设为0;value为必选属性,用来设置定时器的定时值,最小单位为0.1秒。
    请研究下面的例子程序:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
    "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
    < head>
        < meta http-equiv="Cache-Control" content="max-age=0"/>
    < /head>
    < card id="card1" ontimer="#card2">
        < timer name="time1" value="50"/>
        < p align="center">
        After 5s, goto card2
        < /p>
    < /card>
    < card id="card2">
        < onevent type="ontimer">
            < go href="#card1"/>
        < /onevent>
        < timer name="time2" value="50"/>
        < p align="center">
            Here is card2!
        < /p>
    < /card>
    < /wml> 

    再提一下:< onevent>、< timer>、< do>三者必须按以上顺序写。

    此外在页面级还可以加入< template>,用来将事件捆绑在页面级上,语法如下:
    < template onenterforward="url" onenterbackward="url" ontimer="url">
    < do>或者< onevent>
    < /template>
    请研究下面的例子程序:
    < ?xml version="1.0"?>
    < !DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
    < wml>
    < head>
        < meta http-equiv="Cache-Control" content="max-age=0"/>
    < /head>
    < template>
        < do type="accept" label="deckPress" name="do1">
        < go href="#card01"/>
        < /do>
    < /template>
    < card id="card0" ordered="false">
        < do type="accept" label="cardPress" name="do1">
            < go href="#card02"/>
        < /do>
        < p>
            Press ACCEPT...
        < /p>
    < /card>
    < card id="card01">
        < p>
            Here is card01
        < /p>
    < /card>
    < card id="card02">
        < p>
            Here is card02
        < /p>
    < /card>
    < /wml>

  • 打印这篇文章
  • 与本文主题相关的文章
  • 返回首页