WML语法大全
来源:网络 时间:07-08-15 点击: 点击这里收藏本文
method和HTML中的表单FORM的method属性一样,指定表单是以get的方式还是post的方式递交,以便CGI处理。默认的值为get,但如果未指定method但<go>与</go>间存在<postfield>,手机自动以post方式传递。
accept-charset属性可以覆盖HTTP头里指定的字符集。可以写多个字符集,如accept-charset="UTF-8,US-ASCII, ISO-8859-1"。
<postfield name="name" value="value"/>可以看作是HTML表单FORM中的<INPUT TYPE="HIDDEN" NAME="变量名" VALUE="值">,通过它可以向指定的URL传递以“变量名/值”形式的数据。name和value属性都是必选的。注意只有这里的变量是用来递交给CGI程序的。
除了<postfield>,还可以在<go>和</go>之间加入一句或者多句<setvar name="name" value="value"/>。该语句的意思是,当触发某一事件时,给变量赋值。
要注意的是:当<go>和</go>之间没有任何语句时,要用<go/>的形式,这点比较特别。比如:<anchor title="Link1"><go href="test.wml"/>News</anchor>。
<prev> 用来将当前页面的URL压入URL历史堆栈,并打开此前的URL。若该URL不存在,则<prev>无效。语法类似<go>:
<prev><setvar name="name" value="value"/></prev>
<prev>和</prev>之间可加入一句或多句<setvar name="name" value="value"/>。若不加,则必须变成<prev/>的形式。
<refresh> 用来刷新当前的页面,从而使得页面内的变量刷新,语法为:
<refresh><setvar name="name" value="value"/></refresh>
<noop> 表示什么也不做。该标签不能用在<anchor>中,一般用在覆盖页面级的事件模板。
类似于HTML的<FORM>。<fieldset>可用来包括一组表单选项,但不是必须的。前面说过,当<card>的ordered设置为false时,手机可以显示一个概要卡片来总结有效的选项,方便用户从中选取表单选项来填写。概要卡片就是根据<fieldset>和独立的输入框<input>以及选单<select>来总结的。语法为:
<fieldset title="label">表单内容</fieldset>
可选的title属性除了可以用来表示表单的名字外,还在概要卡片里作为选择项的标题。表单内容可以是嵌套的<fieldset>,输入框<input>,选单<select>和必要的提示文本。
<input name="variable" title="label" type="type" value="value" default="default" format="specifier" emptyok="false|true" size="n" maxlength="n" tabindex="n"/> 用来输入文本,除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">
<wml>
<card id="card1" ordered="false">
<p>
USERNAME:<input name="userName" title="User Name" type="text" value="YourNameHere" format="*M" emptyok="false" maxlength="12" tabindex="1"/>
PASSWORD:<input name="password" title="Password" type="password" format="8x" emptyok="false" maxlength="8" tabindex="2"/>
COMMENTS:<input name="comments" title="comment" type="text" value="YourCommentsHere" format="*M" emptyok="true" maxlength="30" tabindex="3"/>
</p>
</card>
</wml>
启动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在起作用。它要求至少输入一个字符。读者自己试试吧!
将上例<card>中的ordered的值改为“true”试试看,然后再在<p>和</p>内加入<fieldset title="field1">和</fieldset>试试看。(Nokia WAP Toolkit好像对这些变化视而不见……)
<select>类似于HTML表单中的<SELECT>。<select>和</select>间可包含<optgroup>和<option>标签,语法如下,所有属性都为可选:
<select title="label" multiple="false|true" name="variable" default="default" iname="index_var" ivalue="default" tabindex="n">
<optgroup title="label">选单内容</optgroup>
<option title="label" value="value" onpick="url"> 事件或者文本 </option>
</select>
title属性,如以上<input>的title属性。
multiple属性,指定用户可否进行多项选择,默认值为false。
name属性,用来存储用户选择项的变量名,其值为<option>标签的value属性。若用户没有选择又没有用default属性指定默认值,则手机将改变量赋值为空字符串(""),对于多项选择,每个值用“;”分开。
default属性,可为name属性指定的变量赋成默认值。
iname属性,用来记录用户选择项的位置,相应的值从1开始。若没选,则该值为0。
ivalue属性,用来记录默认值所在的位置。
<optgroup>可用来将多个<option>分组,<optgroup>和</optgroup>间还可包括<optgroup>和<option>,该标签目前尚未被支持。
<option>,类似于HTML中选单的<option>,用来表示选单的可选项。<option>和</option>间可包括事件和选单的显示文本。<option>的属性为可选,其中value属性用来提供值。当选到该项后,将该值赋给<select>的name属性所指定的变量。onpick属性,用来指定用户选到该项并按ACCEPT键后所打开页面的URL。
为了说明选择项的工作方式,请看下面的例子:
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card id="card0" ordered="false">
<p>
Please select a city...
<select title="Cities List" name="city">
<option title="Beijing" value="c1">Beijing</option>
<option title="Shanghai" value="c2">Shanghai</option>
<option title="Hongkong" value="c3">Hongkong</option>
</select>
Please select columns...
<select title="Column List" multiple="true" name="col">
<option title="Hot News" value="l1">News</option>
<option title="Cool Sports" value="l2">Sports</option>
<option title="Pop Enter,,," value="l3">Entertainment</option>
</select>
</p>
</card>
</wml>
WML的事件基本上分为两大类,一类是键盘(包括软硬按钮)输入事件,用<do>标签来处理。另一类是相关页面内部的事件,用<onevent>标签来处理。
把此文章收藏到: