教程
WML 文档结构祥解
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>