wml语法大全

WML是一种基于XML(扩展标记语言)的一种标记语言。这种语言是为无线设备用户提供交互界面而设计的。这些无线设备包括电话、呼机和个人数字助理(Personal Digital Assistants)等等。
WML是为具有以下特点的设备而设计的:
体积小(相对于个人计算机)。
有限的内存和CPU大小。
通讯带宽窄和时延长。

现在支持WML的设备大致分为两大类:
电话 其特点就是只有4~10行的文本屏幕。用户通过电话的按钮进行输入。
个人数字助理(PDA)其特点就是能支持100×100分辨率(或者更好)。用户能够通过键盘、鼠标或者手写输入。
现在正期待着其他的手持设备同样能支持WML。

因为WML支持许多功能不同的设备,因此文档中列出了这些设备至少应有的功能或者是参考设备。参考设备有以下的特点:
有一个显示屏幕,能显示4行字符,每行12个字符。包括保留给功能按钮的那一行。
支持ASCII的可打印码。
支持数字和字符的输入。
支持使用箭头或者数字按钮进行选择。
两个可编程功能键,ACCEPT和OPTIONS,并且显示在接近键盘的屏幕下。
一个PREV导航键。
支持垂直滚动的箭头按键。

支持水平滚动(不是使用自动换行)。

字符集 WML使用XML的字符集?也就是当前使用的通用的字符集ISO/IEC-10646(Unicode 2.0)并且支持其他系列的子集(例如:US-ASCII、ISO-8859-1或者UTF-8)。不必使用整个Unicode(UCS-4)编码,除非正在使用的不是UTF-8编码。

大小写敏感 不象HTML,WML是一种大小写敏感的语言。所有的标签、属性和枚举属性都必须使用小写。在编写WML页面的时候,必须注意到大小写。包括参数的名字和参数的数值都是大小写敏感的。例如:variable1、Variable1和vaRiable1都是不同的参数。

不显示的字符 表3-2中包括了在WML中不显示的字符:

表 3-2 不显示的字符
字符     8位十进制值
换行     10
回车     13
空格     32
水平制表符  9

除非特别的指定,WML将一个或多个连续的换行、回车、水平制表和空格转换成一个空格。换句话说,忽略所有的多于一个以上的不显示字符。
例子1:

Some text

例子2:
      
      


        Some text  
      


    
 
上面的例子中,手工地使用换行和回车保证程序的可读性,但不是很必要。

文件开场白 所有的WML页面必须在文件的开头处声明XML文件类型:

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"  "http://www.wapforum.org/DTD/wml_1.1.xml">
为了将这个开场白自动地加入到页面中,读者可以使用函数调用来实现。
注意:为了确定WAP浏览器的类型和版本,可以通过捕获HTTP头中的USER_AGENT来进行。
  Content Type 为了建立一个有效的WML信息实体(MIME type),必须在文件的开场白之前指定文件的类型:
Content-type: text/vnd.wap.wml
注意:必须(至少)在Content Type和XML文件声明之前保留一段空行。如果省略,将造成编译器错误。过多空行同样会造成错误。

属性 许多WML标记有一个或多个属性标记,有些是必须的,有些是可选择的。属性可以指定附加的信息,用来确定设备如何解释这些标签。WML标记有以下两种使用方式:
content

必须使用成对的单引号或者双引号将属性值包含在内,每个属性之间使用空格分开。

引用变量 很像UNIX下的Shell变量,可以在格式化的文本、URL、选择文本等等文本内容中使用变量。
使用变量的语法如下:$(myvar)。

特殊字符 WML的保留字符:“<”、“>”、“'”、“"”和“&”。为了在文本中显示这些字符,必须按照表3-3中规定的方式指定。

表 3-3 指定特殊字符
字符       指定方式
<          <

          >
‘          '
"          "
&          &
$          $$
连续空格        
-          ­

分号是字符标签的一个部分,不能省略。如果省略了,将可能会造成WML编译器错误。
注意:与HTML不同的是,当在URL中使用&的时候必须使用&来代替字符&。

WML使用XML文档字符集,目前支持Unicode 2.0。与HTML不同,WML的所有标签、属性和规定的枚举值必须小写。卡片的名字和变量也是区分大小写。和HTML一样,对于连续的空字符,只显示一个空格。标签内属性的值必须用双引号或者单引号括起来。属性名、等号和值之间不能有空格。对于不成对出现的标签,必须在“>”前加“/”。比如:<br/>。在对变量的引用上和HTML基本相同,有以下三种形式:

$(var1:esc)
$(var1:noesc)
$(var1:unesc)
三种形式,具体含义可参见HTML的相关部分。在对保留字符的处理上也基本相同,对应的替代字符请详见“字符实体”。这里要指出的是在URL的传递过程中,用来连接参数的&必须转化为&。

wml文件的一般格式:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">

   
        <access/>
        <meta..../>
   
   
        Some contents...
   


结构看上去和HTML文件很类似,对于每一个页面,在其文档开头必须指明以下的类型声明:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">

千万注意字母的大小写。对于一个页面,其文件大小最好不要超过1.2K。
标签和HTML中的标签一样,用来表明这是一个WML的页面。它有一个可选的“xml:lang”属性来制定文档的语言,比如表示文档语言为中文。
和HTML一样标签包含了该页面的相关信息。标签之间可以包含一个标签和多个标签。
相当于HTML中的标签,指定该页面的访问控制信息。它用两个可选的属性,domain用来指定域,默认值为当前域;path用来指定路径,默认值为“/”,即根目录。由于单独使用,所以要用“/”结尾,以后对于类似的情况不再赘述。
和HTML中的类似,提供了该页面的meta信息。属性是必选的,包括以下三种情况:
 name="name" UP.Link Server忽略meta数据。

 http-equiv="name" UP.Link Server将meta数据转为HTTP响应头(同HTML)。
 user-agent="agent" UP.Link Server直接将meta数据传给手机设备。
content属性也是必选的,其内容根据属性而定。scheme属性目前尚不支持。forua为可选属性,指定在该wml文件传到客户端之前,标签是不是被中间代理删除(因为传输的协议可能改变),默认值为false。

目前支持的meta数据:

指定页面在手机内存缓存中的存储时间段,默认的为30天(除非内存耗尽)。在此期间,手机对于访问过的页面直接从缓存里调用。如果信息是对时间敏感的,可以用max-age指定页面在缓存里的生存期,最小单位是秒。如果指定为0,则每次都需通过连接来调用该页面


类似于普通浏览器的书签功能。当用户将一个卡片做了书签后,手机浏览器首先用一个标记记录该卡片。这个标记默认的是标签中的title属性(以后会讲到)。然后当用户选择了该书签以后,浏览器就会打开被记录的URL。但是因为在默认的情况下,手机会记录所有的页面。所以,一般被用来使手机不要记录当前的URL,即。此外,如果要为书签指定不同于当前页面的URL,用
一个页面可以包含多个卡片,每个卡片的内容可能不止一屏显示,注意页面、卡片和屏幕显示范围的关系。一个卡片用包含。可以包含以下可选的属性:

 id属性用来指定卡片的名字,可用来在卡片间跳转,相当于在HTML中在页内跳转时用
 title属性用来作为书签的标记,该属性一般不会显示在屏幕上。
 newcontext属性(默认值为false)用来指示当跳转到本卡片时,手机是不是要清除以前保留的信息。包括变量、堆栈里的历史记录、重新设置手机状态等。
 ordered属性(默认值是true)表明该卡片里的内容是按固定的顺序显示,还是按用户的选择顺序来显示。这点和HTML不同,卡片里的内容可以按一定的顺序显示。默认的是按线性顺序显示,即按代码的顺序。但是,要注意的是,以下三个标签必须按以下顺序来写:(这和以后要讲的“事件”有关)。这样做是为了方便填表单,当ordered设置为true时,如果一个表单的内容不能在一屏里显示完,就分成多屏显示;当ordered设置为false时,手机可以显示一个概要卡片来总结有效的选项,用户可以从中选取表单选项来填写。
 onXXXX属性,类似于HTML标签中的onXXXX属性,用来捕捉事件。当事件被触发时执行指定的操作(任务),在这里是转向某个URL。

在文本的显示上WML基本和HTML相同。文字段落包含在

之间。align属性指定该段文字的对齐方式,默认的是left。其他可选择right和center;mode属性指定当一行显示不下所有的文字时是否自动换行。默认的是自动换行wrap。如果选nowrap,则在一行中显示,浏览器会通过类似于水平滚动条的机制来显示所有文字。
换行标签也一样为<br/>。这里先提一下,在表单中如果有多个或者,通过它可以向指定的URL传递以“变量名/值”形式的数据。name和value属性都是必选的。注意只有这里的变量是用来递交给CGI程序的。
除了,还可以在之间加入一句或者多句。该语句的意思是,当触发某一事件时,给变量赋值。

要注意的是:当之间没有任何语句时,要用<go/>的形式,这点比较特别。比如:News

用来将当前页面的URL压入URL历史堆栈,并打开此前的URL。若该URL不存在,则无效。语法类似

 之间可加入一句或多句。若不加,则必须变成<prev/>的形式。

 用来刷新当前的页面,从而使得页面内的变量刷新,语法为:

 表示什么也不做。该标签不能用在中,一般用在覆盖页面级的事件模板。

类似于HTML的

可用来包括一组表单选项,但不是必须的。前面说过,当的ordered设置为false时,手机可以显示一个概要卡片来总结有效的选项,方便用户从中选取表单选项来填写。概要卡片就是根据
和独立的输入框以及选单,选单 用来输入文本,除name属性是必要的,其他可选。
 name属性,指定了用来存储该输入文本的变量名字。
 title属性,该输入框的名字,同样可被用来作为概要card页中的选项名。
 type属性,默认值为text,如选择password,则输入的数据显示为*。
 value属性,在语法和行为上等同于下面的default属性。
 default属性,指定输入框的默认值,即name属性指定变量的默认值,当用户输入新值时,该值无效,如果该值不符合以下format属性的规定,则手机忽略该默认值。
 format属性,用来格式化输入的数据,可用的标记如下,使用时可用“一位数字标记”和“*标记”的形式,前者代表N个标记型字符,如3X,后者代表任意个(小于maxlength属性的值)标记型字符。表3-4中包括了在format中常用的枚举数值及其意义。
 maxlength属性,指定了用户可输入的最大字符长度,最大限制为256个字符。
 emptyok属性,表示用户可否不填输入框,默认为false,即要填。
 size属性,输入框显示长度,目前未被支持。
 tabindex属性,类似于在HTML表单中按TAB键后,焦点落在哪个选项上,该值决定了选择顺序,数字大的排在后面。目前未被支持。

表 3-4 格式化标记
标记             描述
A           任何符号或者大写字母(不包括数字)
a           任何符号或者小写字母(不包括数字)
N           任何数字(不包括符号或者字母)
X           任何符号、数字或者大写字母(不可改变为小写字母)
x           任何符号、数字或者小写字母(不可改变为大写字母)
M           任何符号、数字或者大写字母(可改变为小写字母)或者多个字符,默认为首字大写
m           任何符号、数字或者小写字母(可改变为大写字母)或者多个字符,默认为首字小写

为了说明输入格式对用户的影响,请看下面的例子程序:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">


 


    USERNAME:
    PASSWORD:
    COMMENTS:
 



启动Nokia WAP Toolkit,并选择“Go”下的“Open Location”,在输入URL地址后,可以看到模拟器上出现内容。注意光标默认地指在PASSWORD的编辑框内。
选择“Options”进行编辑,多按几次按钮。在输入没有满8个之前选择“OK”,模拟器没有任何反应;当超过8个以后就无法再输入。这就是8x的限制在起作用。并且由于PASSWORD输入属性type为“password”因此显示出来的都是“”。要注意的是:在输入的时候不要太快,否则总在一个字符上切换。如果读者用过手机,应该知道这点。
在删除所有的字符时候,“Clear”变成了“Back”。模拟器返回以前的页面。
当编辑“User Name”的时候,发现输入的自动都变成大写。这是因为M起作用。如果输入超过12个字符,那么将无法再输入字符。这是maxlength在起作用。
当然可以将输入方式切换到小写。
如果这个时候按“OK”,那么USERNAME就变成了“GJTMW.g”。这是由于M前面是“*”的缘故。它不限制输入字符的数目。但是如果将“User Name”中所有的字符清除,再选择“OK”就不行。这是emptyok在起作用。它要求至少输入一个字符。读者自己试试吧!

将上例中的ordered的值改为“true”试试看,然后再在

内加入
试试看。(Nokia WAP Toolkit好像对这些变化视而不见……)

间可包含可用来将多个间还可包括间可包括事件和选单的显示文本。
           
           
       
        Please select columns...
       
   



WML的事件基本上分为两大类,一类是键盘(包括软硬按钮)输入事件,用标签来处理。另一类是相关页面内部的事件,用标签来处理。 3

的语法如下:
任务
任务就是以前提到的四种任务。的属性中,type是必选的,其他为可选。
label属性,指定了软按钮在屏幕上的显示文本。目前type属性为delete、help、prev时该属性无效。
name属性,为取个名字。同一的卡片里的不能重名。如果卡片级的和页面级的同名,则覆盖页面级的
optional属性,指定手机是不是可以忽略这个事件,默认值是false。
type属性,指定触发的事件,具体如表3-5所示:

表 3-5 type的枚举值
枚举值            触发原因
accept            调用ACCEPT按钮机制
delete            调用DELETE按钮机制
help             调用HELP按钮机制
options            调用选择按钮机制
prev             调用PREV按钮机制
reset             调用清除和重新设定手机状态时的RESET机制(目前不支持)
unknown            调用unknown机制。等价于type=""(目前不支持)
Vnd. co-type         调用厂商特定的机制(目前不支持)
X-, x-           供以后使用(不保留)(目前不支持)

为了演示事件的触发过程,请看下面的例子:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//
EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">

   
       
   
   
       
           
       

       


            NAME:
       


   
   
       


            You name is $(userName:noesc).
       


   


使用Nokia WAP Toolkit对该程序进行测试。启动Nokia WAP Toolkit,并选择“Go”下的“Open Location”。在输入URL地址后,可以看到模拟器上出现的界面。在选择“Optionos”后出现了事件选择项。注意到“InputName”是do标签名字。在选择了“InputName”事件后,模拟器上将出现界面输出姓名

的语法如下:
任务
必选属性type的取值如表3-6所示:

表 3-6 type属性的取值
枚举值        如果用户执行了以下操作就执行任务
onpick       用户选择或不选一个

请看下面的例子程序:

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

   
       
   
   
   


        Please select a city...
       
   


   
   
       


            You are Living in $(city:noesc)
       


   

 

<timer/>可以用作在用户不进行任何操作的一段时间后,自动执行一个任务,任何激活卡片页面的任务和用户操作都会启动<timer/>,而任务进行时,<timer/>就停止。每个卡片只能有一个<timer/>,一个<timer/>只能触发一个任务。语法如下:

 其中name为可选属性,指定为一个变量名。当退出该卡片时,该变量存储此时定时器的值。当定时器超时时,手机将该变量设为0;value为必选属性,用来设置定时器的定时值,最小单位为0.1秒。
请研究下面的例子程序:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">


   


   
   


    After 5s, goto card2
   




   
       
   

   
   


        Here is card2!
   



 

再提一下:三者必须按以上顺序写。

此外在页面级还可以加入