WML文件的概念 文档结构详解 事件

WML文件的概念

这里简单介绍一个关于WML文件的概念，其他的细节问题会在后面的章节还详细介绍。

声明
由于WML语言继承于XML，所以一个有效的WML文档必须包含一个XML声明和一个文件类型声明。

以下就是一个最常用的声明，由于WML语法要求非常严格，为了避免出错，制作者可以直接拷贝粘贴到制作文档。

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

注：<?xml version="1.0"?> 语句必须出现在一个Deck的首行，而且必须顶头写，插入任何字符哪怕是空格都会造成语法错误。

主体结构
这是一个最简单的WML文件：



<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.com/DTD/wml_1.1.xml">
<wml>
<card title="sample">
<p>Hello WAP!</p>
</card>
</wml>

WML 文档结构祥解
1、声明（Prologue）
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.com/DTD/wml_1.1.xml">

2、元素（Element）
　　WML首先定义一个Deck，然后在Deck内封装信息和Card。

3、文件头（Head Element）
　　头信息包含与Deck有关的信息，包括meta数据和控制元素。

　　3.1、访问权限设置（Access）

　　该元素用于设置有访问当前Deck权限的列表。如果Deck内不包含Access Element信息，该Deck下的Access Element处于无效状态，其他所有的Deck都可以访问该Deck。

　　相关属性:

　　domain：假如设置 <access domain="sina.com.cn"/> 那么 http://www.sina.com.cn/ 将有访问权限, 而 http://www.sino.com.cn/ 和 http://www.sina.net.cn/ 就没有.

　　path：工作原理与Domain非常相似，例如设置<access path="/internal"/> 那么"/internal/wml" 将获得访问权限，而"/internal-wml"就没有。

示例：

　　做如下设置 <access domain="sina.com.cn" path="/wap"/>

　　那么以下几个Url具有访问权限：

　　http://www.sina.com.cn/wap/goto.cgi
　　http://www.sina.com.cn/wap/index.wml
　　http://www.sina.com.cn/wap/cgi-bin/create_report.cgi?name=123&pwd=234

　　以下的几个Url没有访问权限：

　　http://www.sina.com/wap/getuid.cgi
　　http://www.sina.com.cn/internal/wap/getuid.cgi

3.2、头元素设置（Meta）

　　<meta 属性 content="值" scheme="格式" forua="true|false"/>和HTML中的类似，提供了该DECK的meta信息。

例如：<meta http-equiv="Cache-Control" content="max-age=0" forua="true"/>

　　content属性是必选的，其内容根据属性而定。scheme属性目前尚不支持。forua为可选属性，指定在该wml文件传到客户端之前，<meta>标签是不是被中间代理删除(因为传输的协议可能改变)，默认值为false。

　　目前支持的meta数据:

　　<meta http-equiv="Cache-Control" content="max-age=0"/>指定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"/>。

4、模板（Template）
　　为了节省资源，可以把每个Card中都要用到的Task设置在模板中，供当前Deck中所有Card使用，加入个别Card不需要该模板内容，可以Override掉它（详见任务屏蔽）。

5、卡片（Card）
　　适用事件

　　以下事件适用于Card和Template，参见前面的相关说明。
　　1. onenterbackward
　　2. onenterforward
　　3. ontimer

　　卡片属性（Card）