WML教程8：WML文档结构祥解

WML 文档结构祥解
1、声明（Prologue）

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

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

3.1、访问权限设置（Access）

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

相关属性:

domain：假如设置

1<access domain="sina.com.cn"></access>

那么 http://www.sina.com.cn/ 将有访问权限, 而 http://www.sino.com.cn/ 和 http://www.sina.net.cn/ 就没有.

path：工作原理与Domain非常相似，例如设置

1<access path="/internal"></access>

那么"/internal/wml" 将获得访问权限，而"/internal-wml"就没有。

示例：

做如下设置

1<access domain="sina.com.cn" path="/wap"></access>

那么以下几个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）

1<meta content="值" forua="true|false" scheme="格式" 属性=""/>

和HTML中的类似，提供了该DECK的meta信息。

例如：

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

content属性是必选的，其内容根据属性而定。scheme属性目前尚不支持。forua为可选属性，指定在该wml文件传到客户端之前，

1<meta/>

标签是不是被中间代理删除(因为传输的协议可能改变)，默认值为false。

目前支持的meta数据:

 1<meta content="max-age=0" http-equiv="Cache-Control">指定DECK在手机内存缓存中的存储时间段，默认的为30天(除非内存耗尽)，在该期间，手机对于访问过的DECK直接从缓存里调用。如果信息是对时间敏感的，可以用max-age指定DECK在缓存里的生存期，最小单位是秒，如果指定为0，则每次都需通过连接服务器来调用该DECK。 
 2
 3<meta content="false" user-agent="vnd.up.markable"/>和<meta content="指定的URL" user-agent="vnd.up.bookmark"/>类似于普通浏览器的书签功能。当用户将一个CARD做了书签后，手机浏览器首先用一个标记记录该CARD，这个标记默认的是<card>标签中的title属性(以后会讲到)，然后当用户选择了该书签以后，浏览器就会打开被记录的URL。但是因为在默认的情况下，手机会记录所有的DECK，所以，一般<meta/>被用来使手机不要记录当前的URL，即<meta content="false" user-agent="vnd.up.markable">。此外，如果要为书签指定不同于当前DRECk的URL，用<meta content="指定的URL" user-agent="vnd.up.bookmark"/>。 
 4
 54、模板（Template）   
 6为了节省资源，可以把每个Card中都要用到的Task设置在模板中，供当前Deck中所有Card使用，加入个别Card不需要该模板内容，可以Override掉它（详见任务屏蔽）。 
 7
 85、卡片（Card）   
 9适用事件 
10
11以下事件适用于Card和Template，参见前面的相关说明。   
121\. onenterbackward   
132\. onenterforward   
143\. ontimer 
15
16卡片属性（Card） 
17
18id：同一Deck内Card的唯一标识，可以作为标签被使用。(#nextcard). 
19
20title：卡片标题。不同的浏览器处理标题处理title的原则不一样，有的浏览器会显示标题，如果当前卡片没有设置标题，当前卡片的URL会被显示在标题位置。有些浏览器为了节省显示区域会忽略标题。 
21
22newcontext：默认值为false，用来指示当跳转到本CARD时，手机是不是要清除以前保留的信息，包括变量，堆栈里的历史记录，重新设置手机状态等。 
23
24ordered 布尔变量，声明Card是否有序。通常可以用来开发自动播放的幻灯片效果。 
25
26示例： 
27
28<?xml version="1.0"?>
29<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" " http://www.wapforum.org/DTD/wml_1.1.xml ">
30
31<wml>
32<head>
33<access domain="sina.com.cn" path="/wap"></access>
34</head>
35<template>
36<do label="OK" name="accept1" type="accept">
37<go href="#accept"></go>
38</do>
39</template>
40<card id="start" title="Start Here">
41<p> Start Here. </p>
42</card>
43<card id="accept" title="Okay Card">
44<do label="Okay" name="accept1" type="accept">
45<go href="#accept2"></go>
46<!-- override the same task in template-->
47</do>
48<p> Card Accept </p>
49</card>
50<card id="accept2" title="OK Card">
51<do type="accept">
52<go href="#start"></go>
53</do>
54<p> Card Accept2 </p>
55</card>
56</wml></meta></card></meta>