教程|详解

　　1、声明（prologue）

＜?xml version="1.0"?＞
＜!doctype wml public "-//wapforum//dtd wml 1.1//en" ""＞ 

 
　　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"/＞ 那么 将有访问权限, 而 和 就没有.

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

　　示例：

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

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

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

　　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）

　　id：同一deck内card的唯一标识，可以作为标签被使用。(#nextcard).

　　title：卡片标题。不同的浏览器处理标题处理title的原则不一样，有的浏览器会显示标题，如果当前卡片没有设置标题，当前卡片的url会被显示在标题位置。有些浏览器为了节　　省显示区域会忽略标题。

　　newcontext：默认值为false，用来指示当跳转到本card时，手机是不是要清除以前保留的信息，包括变量，堆栈里的历史记录，重新设置手机状态等。

　　ordered 布尔变量，声明card是否有序。通常可以用来开发自动播放的幻灯片效果。

　　示例：

＜?xml version="1.0"?＞
＜!doctype wml public "-//wapforum//dtd wml 1.1//en" ""＞
＜wml＞

＜head＞
　　＜access domain="sina.com.cn" path="/wap"/＞
＜/head＞

＜template＞
　　＜do type="accept" name="accept1" label="ok"＞
　　　　＜go href="#accept"/＞
＜/do＞
＜/template＞

＜card id="start" title="start here"＞
＜p＞ start here. ＜/p＞
＜/card＞

＜card id="accept" title="okay card"＞
＜do type="accept" name="accept1" label="okay"＞
　　＜go href="#accept2"/＞
＜!-- override the same task in template--＞
＜/do＞
＜p＞ card accept ＜/p＞
＜/card＞

＜card id="accept2" title="ok card" ＞
＜do type="accept" ＞
　　＜go href="#start" /＞
＜/do＞
＜p＞ card accept2 ＜/p＞
＜/card＞

＜/wml＞