XML基础说明

由于网络带宽以及某些WAP服务器DECK传输的限制,所以DECK越小越好,最好不要超过1.2K。如果你的需求很复杂,最好分成几个DECK来完成。

完整的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>
   .
   . 头信息......
   .
  </head>
  <template>
   .
   . 模板定义......
   .
  </template>
  <card>
   .
   . 内容......
   .
   </card>
   .
   . 其他card(可有可无)......
   .
</wml>

XML说明

DECK开头必须指明以下的XML类型声明:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
  "http://www.wapforum.org/DTD/wml_1.1.xml">

第一行指出XML版本,紧跟的文档类型(DOCTYPE)声明指出所引用的语言标准定义(wml_1.1.xml的内容可以察看本教程附录中的DTD说明)。

这两句的位置和顺序不可更改,而且中间不能有空行。


<wml>
语法:
<wml>标签和HTML中的<html>标签一样,用来表明这是一个WML的DECK。xml:lang属性来指定文档的语言,比如<wml xml:lang="zh">表示文档语言为中文。

<head>

<head>标签包含了该DECK的相关信息。<head>标签之间可以包含一个<access>标签和多个<meta>标签。

<access>语法:

<access
   domain="STRING"
   path="STRING" />

<access>相当于HTML中的<BASE>标签,指定该DECK的访问控制信息,它的两个属性是可选的。

domain:指定域,默认值为当前域。
path:指定路径,默认值为"/",即根目录。

<meta>语法:

<meta
   http-equiv="STRING" | name="STRING"
   forua="true|false"
   content="STRING"
   scheme="STRING" />

和HTML中<META>的类似,<meta>提供了该DECK的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"/>指定DECK在手机内存缓存中的存储时间段,默认的为30天(除非内存耗尽),在该期间,手机对于访问过的DECK直接从缓存里调用。如果信息是对时间敏感的,可以用max-age指定DECK在缓存里的生存期,最小单位是秒,如果指定为0,则每次都需通过连接服务器来调用该DECK。

  <meta user-agent="vnd.up.markable" content="false"/>和<meta user-agent="vnd.up.bookmark" content="指定的URL"/>类似于普通浏览器的书签功能。当用户将一个CARD做了书签后,手机浏览器首先用一个标记记录该CARD,这个标记默认的是<card>标签中的title属性(以后会讲到),然后当用户选择了该书签以后,浏览器就会打开被记录的URL。但是因为在默认的情况下,手机会记录所有的DECK,所以,一般<meta>被用来使手机不要记录当前的URL,即<meta user-agent="vnd.up.markable" content="false"/>。此外,如果要为书签指定不同于当前DRECk的URL,用<meta user-agent="vnd.up.bookmark" content="指定的URL"/>。

<template>
<template>元素声明一个DECK级的事件/请求,对DECK页面中所有CARD有效,当然某个CARD可以通过定义同名的事件来替代<template>声明中的事件处理。

语法:

<template
   onenterforward="STRING"
   onenterbackward="STRING"
   ontimer="STRING" />

onenterforward:当用户通过<go>进入CARD时调入的链接。
onenterbackward:当用户通过<prev>退回CARD时调入的链接。
ontimer:<timer>事件激活时调入的链接。

例子(其中涉及的其他命令参考其他章节):

<wml>
<template>
  <do type="options" name="do1" label="default">
  <prev/>
  </do>
</template>
<card id="first">
  <!-该卡片将自动套用模块中定义的事件处理过程-->
   …
  </card>
<card id="second">
  <!-使用空操作(noop)来屏蔽模块中定义的事件处理过程->
  <do type="options" name="do1">
   <noop/>
  </do>
   …
</card>
<card id="third">
  <!-该卡片使用同名的事件处理替代模块中提供的事件处理->
  <do type="options" name="do1" label="options>
   <go href="/options"/>
  </do>
</card>
</wml>

另外可以参看事件(EVENT)。

<card>
一个DECK可以包含多个CARD,每个CARD的内容可能不止一屏显示,注意DECK、CARD和屏幕显示范围的关系。一个CARD用<card>和</card>包含。

语法:

<card
  id="STRING"
  title="STRING"
  newcontext="true|false"
  ordered="true|false"
  onenterforward="STRING"
  onenterbackward="STRING"
  ontimer="STRING"
  xml:lang="STRING">  

每个CARD元素可以有一个标号(ID)和标题(TITLE)。当然,这都不是必须的。

id:CARD的名字,在DECK中唯一,可用作URL已进行跳转。

title:CARD的标题,用户BOOKMARK一个CARD时的名字。该属性在某些用户终端上会显示出来。

newcontext:用来指示当跳转到本CARD时,用户终端(手机、模拟器等)是不是要清除以前保留的信息如变量、堆栈历史记录、终端状态等。默认值为FALSE。

ordered:表明该CARD里的内容是按固定的顺序显示,还是按用户的选择来显示。默认值是TRE。这点和HTML不同,CARD页面里的内容可以按一定的顺序显示,默认的是按线性顺序显示,即按代码的顺序,但是,要注意的是,以下三个标签必须按以下顺序来写<onevent> <timer> <do>,(这和以后要讲的“事件”有关)。这样做是为了方便填表单,当ordered设置为true时,如果一个表单的内容不能在一屏里显示完,就分成多屏显示;当ordered设置为false时,手机可以显示一个概要CARD来总结有效的选项,用户可以从中选取表单选项来填写。

onenterforward:当用户通过<go>进入CARD时调入的链接。
onenterbackward:当用户通过<prev>退回CARD时调入的链接。
ontimer:<timer>事件激活时调入的链接。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值