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)
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" "http://www.wapforum.org/dtd/wml_1.1.xml">
<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>
- 上一篇: WML初级教程之关于WML的事件
- 下一篇: XML实现三维字技巧