WAP初级教程2
WAP初级教程2
2005年4月21日 作者： 转载出处： 推荐人：szgamer 我要爆料将本文转发至：|||||--事件 (EVENT)
<anchor> 链接
<onevent> 固有事件
<timer> 计时器
<do> 用户触发事件
DECK级事件
任务不能在真空中生存，它们必须绑定倒某个事件上才能做一些有用的事情。事件发生--〉任务执行，这才是完整的进程控制。
有4个元素可以帮助你完成事件对任务的绑定：<anchor>、<onevent>、<timer>和<do>。
<anchor> 链接
象HTML一样，WML也可以定义到其他程序的链接。在HTML中，链接通常用下划线和特殊颜色的方式表示跟其他内容的区别。在WAP终端上则没有严格的规则说如何表示一个链接，一般采用反白的显示方式。
<anchor>的语法如下：
<anchor
title="STRING"
xml:lang="STRING"
>
<br>, <go>, <img>, <prev>, <refresh>, TEXT
</anchor>
title：链接的标题；
xml:lang：语言编码。
在这种定义方式中，实际上链接一般是通过<anchor>中包括的<go>元素完成的。比如下面的例子定义了2个CARD，点击第一个CARD里的“click me”链接会跳转到第2个CARD：
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http ://www.wapforum.com/DTD/wml_1.1.xml">
<wml>
<card id="Hello" title="Hello">
<p>Hello,
<anchor>click me
<go href="#bye"/>
</anchor>
</p>
</card>
<card id="bye" title="Bye">
<p>Bye, guys</p>
</card>
</wml>
点击前显示： 点击后显示：
------- Hello -------
Hello,
-------- bye --------
Bye, guys
链接还有一种短格式，语法如下：
<a
href="STRING"
title="STRING"
xml:lang="STRING"
>
<br>, <img>, TEXT
</a>
除了跟原来一样的两个属性以外，多了href属性，可以对它直接指定URL。例如下面的例子定义了一个带有图像的链接：
<a title="HotBars" href="www.wap86.net/HotBars.wml">
<img src="hot.wbmp" alt="WAP初级教程二" />
</a>
除了跟原来一样的两个属性以外，多了href属性，可以对它直接指定URL。
<onevent> 固有事件 [TOP]
WML定义了4种由用户终端触发的固有事件：
oneventforward：当用户被<go>任务或其他机制（如一个SCRIPT过程）引导到一个CARD时触发；
oneventbackward：当用回被<prev>或其他机制（如在设备上按BACK按钮）引导到一个CARD时触发；
ontimer：当TIMER计时结束时触发。定义TIMER计时器可以使用<timer>元素，见下一节；
onpick：当用户按下一个<option>选项时触发（可以是选中或取消选择）。
把这些事件绑定到一个任务要使用<onevent>元素，它的语法如下：
<onevent
type="oneventforward | oneventbackward | ontimer | onpick"
>
<go>, <noop>, <prev>, <refresh>
</onevent>
下面的例子演示了如何使用固有事件在CARD调入时清空变量。
<?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">
<onevent type="oneventforward">
<refresh>
<setvar name="firstname" value=""/>
<setvar name="lastname" value=""/>
</refresh>
</onevent>
<p>
You have no name!
</p>
</card>
</wml>
<timer> 计时器 [TOP]
看名字就知道，这是个计时器，它在经过规定的计时时间以后产生一个任务。<timer>计时器只在所属CARD里有效：当进入CARD时，计时器开始工作；时间一到，触发任务；如果离开CARD，计时器停止。语法如下：
<timer
name="STRING"
value="NUMBER"
/>
name：可选。指定一个包含计时时间的变量，在计时器开始工作以后，变量的值会逐渐减少。如果这个变量在<timer>之前就已经存在并且赋值为一个非负整数，那后面value属性的值会被忽略，直接使用变量里的值作为计时时限。
value：必选。指定计时时间，以1/10秒为单位。
下面的例子每隔1秒显示不同的文字（当然，你有兴趣改成图像也可以）。
<?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="Hello" title="Hello">
<onevent type="ontimer">
<go href="#card2">
</onevnet>
<timer value="10"/>
<p>Hello!</p>
</card>
<card id="Take care">
<onevent type="ontimer" title="Take care">
<go href="#card3">
</onevnet>
<timer value="10"/>
<p>R U tired?</p>
</card>
<card id="Rest">
<onevent type="ontimer" title="Rest">
<go href="#card1">
</onevnet>
<timer value="10"/>
<p>Take a rest!</p>
</card>
</wml>
显示结果如下，注意会不断循环。 Sport选择：
第1秒 第2秒 第3秒
------ Hello ------
Hello!
----- Take care ----
R U tired?
------- Rest -------
Take a rest!
还有一个例子，通常用来做网站封面，显示一段欢迎词以后进入正式内容。这里没有使用图片，各位可以自己加上试试看。
<?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="Welcome to WAP86" ontimer="wap86.wml">
<timer value="30"/>
<p>
Hello!
Welcome to WAP86 - the paradise of WML developers.
</p>
</card>
</wml>
部件 功能
accept 确认，接受输入
prev 退回历史页面访问堆栈里上一个CARD
help 上下文关联的帮助信息
reset 重设设备状态
options 上下文关联的选项或附加操作
delete 删除当前内容或选择
unknown 由开发者自己定义
<do> 用户触发事件 [TOP]
每个WAP终端都预定义了一系列用户界面部件，如手机上的按钮、触摸屏上的图表、声音指令或者其他一些很容易是别的部件。WML1.1定义了右面那些WAP兼容终端必须支持的部件。但是要说明的是，只有prev有预先定义的功能，其他的只是概念上的定义，需要根据开发者激活并赋予一定的动作。
当用户激活这些部件的时候会产生相应的事件。你可以使用<do>元素捕获这些事件并对其做出反应。下面是<do>的语法：
<do
type="accept | prev | help | reset | options | delete | unknown"
lebel="STRING"
name="STRING"
optional="true | false"
xml:lang="STRING"
>
<go> | <noop> | <prev> | <refresh>
</do>
type：必选属性，内容只能是那7种；
label：用户接口部件的显示标签。如果终端不能显示则被忽略。WML1.1建议此属性长度限制在6个英文字符以内；
name：标志“事件/任务”绑定关系的唯一名称（在CARD范围内）。CARD级的<do>事件替换同名的DECK级<do>事件（见下一节）。如果不指定name属性或name为空字符串，则name默认为type的类型；
optional：告诉终端此软按钮在屏幕中是否显示。如果此值设为true，则忽略本<do>元素。默认值为false；
xml:lang任务：语言代码。
跟其他“事件/任务”绑定关系一样，<do>里的任务定义必须是<go>、<noop>、<prev>或<refresh>中的一个。
下面例子演示了<do>的使用方法。用户按了不同的按钮会被导向不同的CARD。
<?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" title="WAP86 Links">
<do type="accept" label="Links" optional="false">
<go href="#Links"/>
</do>
<do type="help" label="Help" optional="false">
<go href="#Help"/>
</do>
<p> WAP86's perfect links</p>
</card>
<card id="Links" title="WAP86 Links">
<p> Select one:<br><br>
<a href="www.wap86.net">WAP86</a><br>
<a href="www.at86.com">AT86</a>
</p>
</card>
<card id="help" title="Help">
<do type="accept" label="Links" optional="false">
<go href="#Links"/>
</do>
<p>
Select "Links" button to view the links.
</p>
</card>
</wml>
显示结果
主画面： 按下“Links”按钮以后： 按下“Help”按钮以后：
---- WAP86 Links ---
WAP86's perfect links
Links Help
---- WAP86 Links ---
Select one:
>[ WAP86 ]
[ AT86 ]
------- Help -------
Select "Links" button to view the links.
Links
DECK级事件 [TOP]
前面（DECK一节，关于<template>）已经讲过可以用<template>元素定义DECK级事件，做法跟CARD级事件一样，只要在<template>元素里包含<do>或<onevent>事件就可以。这种做法可以定义一些在每个CARD里都需要定义的事件，而不需要重复说明。比如下面的例子给所有的CARD定义了BACK按钮以便返回上一页：
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<template>
<do type="prev" label="BACK" optional="false">
<prev/>
</do>
</template>
<card id="Links" title="WAP86 Links">
<do type="help" label="Help" optional="false">
<go href="#Help"/>
</do>
<p> Select one:<br><br>
<a href="www.wap86.net">WAP86</a><br>
<a href="www.at86.com">AT86</a>
</p>
</card>
<card id="help" title="Help">
<do type="accept" label="Links" optional="false">
<go href="#Links"/>
</do>
<p>
Select "Links" button to view the links.
</p>
</card>
</wml>
