WML教程

关注公众号 jb51net

关闭
首页 > 网络编程 > XML/RSS > WML教程 >

WML语法大全与相关介绍

作者:

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 指定特殊字符
字符       指定方式
<          &lt;
>          &gt;
‘          &apos;
"          &quot;
&          &amp;
$          $$
连续空格       &nbsp;
-          &shy;
分号是字符标签的一个部分,不能省略。如果省略了,将可能会造成WML编译器错误。
注意:与HTML不同的是,当在URL中使用&的时候必须使用&amp;来代替字符&。
WML使用XML文档字符集,目前支持Unicode 2.0。与HTML不同,WML的所有标签、属性和规定的枚举值必须小写。卡片的名字和变量也是区分大小写。和HTML一样,对于连续的空字符,只显示一个空格。标签内属性的值必须用双引号或者单引号括起来。属性名、等号和值之间不能有空格。对于不成对出现的标签,必须在“>”前加“/”。比如:<br/>。在对变量的引用上和HTML基本相同,有以下三种形式:
$(var1:esc) 
$(var1:noesc) 
$(var1:unesc) 
三种形式,具体含义可参见HTML的相关部分。在对保留字符的处理上也基本相同,对应的替代字符请详见“字符实体”。这里要指出的是在URL的传递过程中,用来连接参数的&必须转化为&amp;。
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>
阅读全文