WAP初级教程

发布时间:2007年02月07日      浏览次数:3109 次
任务(TASK)
<noop>
<prev>
<refresh>
<go>
  前面我们已经讲过如何在WML中显示内容。不过任何程序员都知道,没有结构和进程就没有程序。在WML中定义进程有很多方法,最简单的就是任务。
  WAP1.1定义了几种类型的任务,任务通过对事件(有关事件的详细解释见下一章事件)的响应改变程序的运行顺序。有四种WML任务: <noop>、 <prev>、 <refresh>和 <go>。
<noop> [TOP]
这个任务不做任何事情,一般用于屏蔽DECK级事件(参见桌面和事件),语法非常简单:
<noop/>
<prev> [TOP]
当用户激活该任务时,终端就转回上次用户访问过的URL。语法如下:
<prev>
   <setvar>
   ......
</prev>
如果<prev>中包含了<setvar>元素,就会优先处理。下面例子定义了一个只有Back按钮的的DECK,按下以后会返回前面看过页面。
<?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>
    Back
    <prev/>
   </anchor>
  </p>
</card>
</wml>
<refresh> [TOP]
当用户激活该任务时,就执行一个刷新过程。如果这个任务里使用<setvar>定义了变量,变量值将被重新设置。语法如下:
<prev>
   <setvar>
   ......
</prev>
如果当前CARD含有<timer>元素,那么在刷新时<timer>优先启动。
下面的例子定义在屏幕刷新时重设firstname、lastname和age变量。
<do type="refresh">
  <refresh>
   <setvar name="firstname" value="david">
   <setvar name="lastname" value="smith">
   <setvar name="age" value="29">
  </refresh>
</do>
<go> [TOP]
当用户激活该任务时,就引导用户去WML中指定URL,可以是服务器上其他的DECK,也可以是本DECK中其他的CARD。语法如下:
<go
   accept-charset="STRING"
   href="URL"
   method="post|get" sendreferer="true|false" >
   <postfield>, <setvar>......
</go>
href:必选属性,指向一个合法URL。如果是其他的DECK,则该DECK的第一个CARD会显示出来。如果是本DECK中的其他CARD,而历史堆栈里保存的是最新数据的话,则堆栈保持不变,直接调入该CARD。
sendreferer:如果为true,用户主体信息(USER AGENT)必须传送给WAP网关。传送时使用HTTP的提交头信息,即尽可能简短的相对URL。这个属性可以用来给服务器控制存取URL的权力。默认值为false。
Method:值必须为get或post。分别用来产生HTTP的GET和POST请求。若为get,则在URL中列出参数,例如:“http://www.wap86.net/bob.cgi?argone=one”;若为post,则数据在请求内部传送,不需要在URL中列出。
Accept-charset:指定字符集名称列表,服务器在接受<go>的时候必须接受这个编码规则。默认值为unknown。具体内容这里不作解释,在以后的高级教程中描述。
下面是一个简单的例子:
<go href="../topic.wml" sendreferer="true">
<postfield> [TOP]
<postfield>并不是一个任务,但是跟<go>任务有关,所以在这里介绍。它用来定义“名称/值”对以便通过<go>向服务器发送HTTP请求。语法如下:
当用户激活该任务时,就引导用户去WML中指定URL,可以是服务器上其他的DECK,也可以是本DECK中其他的CARD。语法如下:
下面是一个简单的例子:
<postfield name="STRING" value="STRING" />
当一个含有<postfield>的任务被执行的时候,终端要完成这样一个过程:
1、识别“名称/值”对并准备参数变量;
2、参数变量转换成正确的字符集;
3、根据URL的ESCAPE规则对参数进行ESCAPE转码,编译成application/x-www-form-urlencoded的MIME类型;
4、根据method指定的请求模式提交任务。
下面的例子演示get模式的用法:
<go href="../news.asp" sendreferer="true" method="get">
  <postfield name="newstype" value="technology"/>
  <postfield name="newstext" value="wml"/>
</go>
服务器将收到这样的get请求:
GET ../news.asp?newstype=technology&newstext=wml HTTP/1.1
.
. 其他HTTP头信息
.
如果把前面的请求模式改成post,则同样的<go>任务产生的这样的post请求:
POST../news.asp HTTP/1.1
content-type="xxx-urlencoded" .
. 其他HTTP头信息
.
newstype=technology&newstext=wml
事件 (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="Hot Bars" />
</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>
文章来源:http://www.host01.com/article/Wap/wap001/0592216285398005.htm
免责声明:本站相关技术文章信息部分来自网络,目的主要是传播更多信息,如果您认为本站的某些信息侵犯了您的版权,请与我们联系,我们会即时妥善的处理,谢谢合作!