由于网络带宽以及某些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说明 [TOP]
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> [TOP] 语法:
<wml>标签和HTML中的<html>标签一样,用来表明这是一个WML的DECK。xml:lang属性来指定文档的语言,比如<wml xml:lang="zh">表示文档语言为中文。
<head> [TOP]
<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> [TOP] <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> [TOP] 一个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>事件激活时调入的链接。
不同浏览器指标 [TOP]
> |
Nokia 7110> |
Ericsson R320> |
Ericsson R380> |
UP.Browser> |
CARD最大字节数> |
1397 字节> |
3000 字节> |
3800 字节> |
1492 字节> |
图象最大字节数> |
1397 字节> |
3000 字节?> |
3800 字节?> |
1492 字节?> |
显示行数> |
4 (含标题行)> |
5> |
7> |
视终端不同>
S3568i:6> |
显示列数> |
19> |
14> |
不知道> |
视终端不同> |
显示宽度(象素)> |
95> |
101> |
304> |
视终端不同> |
显示高度(象素)> |
45> |
52> |
98> |
视终端不同> |
象素比例> |
1:1.25> |
不知道> |
1:1.23> |
视终端不同> |
字体> |
无> |
Small, Bold, Emphasis, Strong> |
Small, Big, Bold, Italic, Emphasis, Strong> |
Small, Big, Bold> |
文字位置> |
没有,强制居左> |
居左、居中、居右> |
居左、居中、居右、段落缩进> |
不知道> |
图象位置> |
强制居左> |
不知道> |
不知道> |
不知道> |
表格支持> |
不支持> |
最多5x5格> |
不知道> |
不知道> |
触摸屏> |
无> |
无> |
有> |
无> |
图标键> |
无> |
无> |
有> |
不知道> |
在WML页面内拨号> |
"提取号码" 功能> |
通过WTAI支持> |
通过WTAI支持> |
3.1以上版本的浏览器支持> |
输入> |
在行内输入> |
在设置位置输入> |
在设置位置输入> |
不知道> |
输入格式> |
只有大小写> |
不知道> |
不知道> |
不知道> |
图形链接> |
无> |
有> |
有> |
不知道> |
链接格式> |
在行内> |
在设置位置> |
在设置位置> |
不知道> |
DECK下载顺序> |
文字,然后图形,再开始选择性计时> |
文字,开始选择性计时,然后是图(结果有可能是CARD还未下载完毕就已过时)> |
不知道> |
> |
HTTP Redirect> |
支持> |
支持> |
支持> |
支持> |
|