jayjayjayjayjayjay
jayjayjayjayjayjay

WML学习(转http://myalice.51.net/wapteach07.htm)

WML学习（一）

--------------------------------------------------------------------------------
 
 概述
WML（Wireless Markup Language - 无线标记语言）这种描述语言同我们常听说的HTML语言同出一家，都

属于X ML语言这一大家族。HTML语言写出的内容，我们可以在我们的PC机上用IE或是Netscape等浏览器进

行阅读，而 WML语言写出的文件则是专门用来在手机等的一些无线终端显示屏上显示，供人们阅读的，并

且同样也可以向使用者提供人机交互界面，接受使用者输入的查询等信息，然后向使用者返回他所想要获

得的最终信息。

 基本规则
* WML使用XML文档字符集，目前支持 Unicode 2.0，和HDML不同，WML的所有标签，属性和规定的可接收

值必须小写，CARD的名字和变量也是区分大小写的。和HDML一样，对于连续的空字符，只显示一个空格。

标签内属性的值必须用"或者'括起来，属性名，＝和值之间不能有空格。对于不成对出现的标签，必须在

> 前加 / ，比如
。在对变量的引用上和HDML基本相同，有：
　　 $(var1:esc)
　　 $(var1:noesc)
　　 $(var1:unesc)
三种形式，具体含义参见前面HDML的相关部分。在对保留字符的处理上也基本相同，对应的取代字符有：
　　 < <
　　 > >
　　 ' '
　　 " "
　　 & &
　　 $ $$
　　 空格  
　　 - ­
这里要指出的是在URL的传递过程中，用来连接参数的 & 必须转化为 &。
WML学习（二）

--------------------------------------------------------------------------------
 
 基本格式和文件头
wml文件的一般格式：









Some contents...

　　 结构看上去和HTMl文件很类似，对于每一个DECK，在其文档开头必须指明以下的类型声明：


千万注意字母的大小写。对于一个DECK，其文件大小最好不要超过1.2K。

　　 标签和HTML中的标签一样，用来表明这是一个 WML的DECK，它有一个可选的xml:lang属性来制定文档的语言，比如表示文档语言为中文。

　　 和HTML一样标签包含了该DESK的相关信息。 标签之间可以包含一个标签和多个标签。

　　 相当于HTML中的标签，指定该DECK的访问控制信息，它用两个可选的属性，domain用来指定域，默认值为当前域， path用来指定路径，默认值为"/"，即根目录。由于 单独使用，所以要用/结尾，以后对于类似的情况不再赘述。

　　 和HTML中的类似，提供了该DECK的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数据:
　　 指定DECK在手机内存缓存中的存储时间段，默认的为30天(除非内存耗尽)，在该期间，手机对于访问过的DECK直接从缓存里调用。如果信息是对时间敏感的，可以用max-age指定DECK在缓存里的生存期，最小单位是秒， 如果指定为0， 则每次都需通过连接服务器来调用该DECK。

　　 和 类似于普通浏览器的书签功能。当用户将一个CARD做了书签后，手机浏览器首先用一个标记记录该CARD，这个标记默认的是标签中的title属性(以后会讲到)，然后当用户选择了该书签以后，浏览器就会打开被记录的URL。但是因为在默认的情况下，手机会记录所有的DECK，所以，一般被用来使手机不要记录当前的URL，即
。此外， 如果要为书签指定不同于当前DRECk的 URL，用。

　　 一个DECK可以包含多个CARD，每个CARD的内容可能不止一屏显示，注意DECK，CARD和屏幕显示范围的关系。一个CARD用和包含。可以包含以下可选的属性：

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

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

和

之间，align属性指定该段文字的对齐方式，默认的是left，其他可选择right和center；mode属性指定当一行显示不下所有的文字时是否自动换行，默认的是自动换行wrap，如果选nowrap，则在一行中显示，浏览器会通过类似于水平滚动条的机制来显示所有文字。

　　 换行标签也一样为
，这里先替一下，在标单中如果有多个或者，通过它可以向指定的URL传递以“变量名/值”形式的数据。name和value属性都是必选的。注意只有这里的变量是用来递交给CGI程序的。

　　 除了，还可以在和间加入一句或者多句，该语句的意思是，当触发某一事件时，给变量赋值。

　　 要注意的是，当和之间没有任何语句时，要用的形式，这点比较特别，比如News。

　　 2)用来将当前页面的URL压入URL历史堆栈，并打开此前的URL，若该URL不存在，则无效。语法类似：，和之间可加入一句或多句，若不加，则必须变成的形式。

　　 3)用来刷新当前的页面，从而使得页面内的变量刷新，语法为。

　　 4)，表示什么也不做，该标签不能用在中，一般用在覆盖DECK级的(以后会说明) 
 
WML学习（五）

--------------------------------------------------------------------------------
 
 显示表单
类似于HTML的

，
可用来包括一组表单选项，但不是必须的。前面说过，当的ordered设置为false时，手机可以显示一个概要CARD来总结有效的选项，方便用户从中选取表单选项来填写，概要CARD就是根据
和独立的输入框以及选单，选单，用来输入文本，除了name属性是必要的，其他可选。
　　 *name属性，指定了用来存储该输入文本的变量名字。
　　 *title属性，该输入框的名字，同样可被用来作为概要CARD页中的选项名。
　　 *type属性，默认值为text，如选择password，则输入的数据显示为*。
　　 *value属性，在语法和行为上等同于下面的default属性，
　　 *default属性，指定输入框的默认值，即name属性指定变量的默认值，当用户输入新值时，该值无效，如果该值不符合以下format属性的规定，则手机也忽略该默认值。
　　 *format 属性，用来格式化输入的数据，可用的标记如下，使用时可用“一位数字标记”和“*标记”的形式，前者代表N个标记型字符，如3X， 后者代表任意个(小于maxlength属性的值)标记型字符。
　　 标记　　　描述
　　 A 　　　　任何符号或者大写字母(不包括数字)
　　 a 　　　　任何符号或者小写字母(不包括数字)
　　 N 　　　　任何数字(不包括符号或者字母)
　　 X 　　　　任何符号、数字或者大写字母(不可改变为小写字母)
　　 x 　　　　任何符号、数字或者小写字母(不可改变为大写字母)
　　 M 　　　　任何符号、数字或者大写字母(可改变为小写字母)或者多个字符，默认为首字大写
　　 m 　　　　任何符号、数字或者小写字母(可改变为大写字母)或者多个字符，默认为首字小写

　　 *maxlength属性，指定了用户可输入的最大字符长度，最大限制为256个字符。
　　 *emptyok属性，表示用户可否不填输入框，默认为false，即要填。
　　 *size属性，输入框显示长度，目前未被支持。
　　 *tabindex属性，类似于在HTML表单中按TAB键后，焦点落在哪个选项上，该值决定了这个选择顺序，数字大的排在后面。目前未被支持。

test4.wml
---------------




USERNAME:
PASSWORD:
COMMENTS:




　　 将上例中的odered的值改为"true"试试看，然后再在

和

内加入
和
试试看。

　　 ，间可包含和

　　 可用来将多个和间还可包括和

　　 间可包括事件(见下节)和选单的显示文本。



Please select columns...




 WML学习（六）

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

　　 的语法如下：任务，任务就是以前提到的四种任务。的属性中，type是必选的，其他为可选。
　　 *label属性，指定了软按钮在屏幕上的显示文本。目前type属性为delete，help，prev时该属性无效。　
　　 *name属性，为取个名字，同一的CARD里的不能重名。如果CARD级的和DECK级的同名，则覆盖DECK级的。
　　 *optional属性，指定手机是不是可以忽略这个事件，默认值是false。
　　 *type属性，指定触发的事件，具体如下；
　　 type值 　　　触发原因
　　 accept　 　　调用ACCEPT按钮机制
　　 delete　　 　调用DELETE按钮机制
　　 help　　　 　调用HELP按钮机制
　　 options　　 调用选择按钮机制
　　 prev　　　　 调用PREV按钮机制
　　 reset　　　 调用清除和重新设定手机状态时的RESET机制(目前不支持)
　　 unknown 　 　调用unknown机制，等于type=""(目前不支持)
　　 vnd. co-type 调用厂商特定的机制(目前不支持)
　　 X-*, x-* 　　供以后使用(不保留)(目前不支持)

test6.wml
---------------










NAME:





You name is $(userName:noesc).



　　 的语法如下，任务，必选属性type的取值如下:
　　 type值　　　　　如果用户执行了以下操作就执行任务
　　 onpick　　　　　用户选择或不选一个

test7.wml
---------------







Please select a city...





You are Living in $(city:noesc)



　　 可以用来在用户不进行任何操作的一段时间后，自动执行一个任务，任何激活CARD页面的任务和用户操作都会启动，而任务进行时，就停止。每个CARD只能有一个，一个只能触发一个任务。语法如下：，其中name为可选属性，指定为一个变量名，当退出该CARD时，该变量存储此时定时器的值，当定时器超时时，手机将该变量设为0；value为必选属性，用来设置定时器的定时值，最小单位为0.1秒。

test8.wml
---------------








After 5s, goto card2









Here is card2!



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

　　 此外在DECK级还可以加入