WML 的事件大致分為兩類:一類是鍵盤(含軟硬按鍵)輸入事件,用 <do> 標籤處理;另一類是頁面內部的相關事件,用 <onevent> 標籤處理。
語法:<do type="type" label="label" name="name" optional="false|true">任務</do>,任務即前面介紹過的四種。屬性中 type 為必選,其餘可選。
type 值 觸發原因
accept 呼叫 ACCEPT 按鍵機制
delete 呼叫 DELETE 按鍵機制
help 呼叫 HELP 按鍵機制
options 呼叫選擇按鍵機制
prev 呼叫 PREV 按鍵機制
reset 呼叫清除並重設手機狀態的 RESET 機制(目前不支援)
unknown 呼叫 unknown 機制,等同 type=""(目前不支援)
vnd.*-type 呼叫廠商特定機制(目前不支援)
X-*, x-* 保留供未來使用(目前不支援)
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "https://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<card id="card0" ordered="false">
<do type="accept" label="InputName" name="do1">
<go href="#card01"/>
</do>
<p>
NAME: <input name="userName" title="User Name" type="text" format="*M" emptyok="false" maxlength="12"/>
</p>
</card>
<card id="card01">
<p>
Your name is $(userName:noesc).
</p>
</card>
</wml>
語法:<onevent type="type">任務</onevent>,必選屬性 type 的取值如下:
type 值 觸發時機
onpick 使用者選取或不選某個 <option> 項時
onenterforward 使用者以 <go> 任務抵達某個 Card 時
onenterbackward 使用者以 <prev> 任務返回前面的 Card,或按 BACK 鍵時
ontimer 當 <timer> 逾時時
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "https://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<card id="card0" ordered="false">
<p>
Please select a city...
<select title="Cities List" name="city">
<option title="Beijing" value="Beijing">
<onevent type="onpick">
<go href="#card01"/>
</onevent>Beijing</option>
<option title="Shanghai" value="Shanghai" onpick="#card01">Shanghai</option>
<option title="Hongkong" value="Hongkong" onpick="#card01">Hongkong</option>
</select>
</p>
</card>
<card id="card01">
<p>
You are living in $(city:noesc)
</p>
</card>
</wml>
<timer/> 可以在使用者一段時間內不做任何操作後自動執行任務。任何激活 Card 頁面的任務與使用者操作都會啟動計時器,任務執行期間計時器停止。每個 Card 只能有一個 <timer/>,且一個 <timer/> 只能觸發一個任務。
語法:<timer name="variable" value="value"/>。name 為選擇性屬性,指定一個變量名,退出該 Card 時變量會儲存此時的計時值,計時逾時時手機把該變量設為 0;value 為必選,用來設定計時值,最小單位為 0.1 秒。
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "https://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<card id="card1" ontimer="#card2">
<timer name="time1" value="50"/>
<p align="center">
After 5s, goto card2
</p>
</card>
<card id="card2">
<onevent type="ontimer">
<go href="#card1"/>
</onevent>
<timer name="time2" value="50"/>
<p align="center">
Here is card2!
</p>
</card>
</wml>
再提醒一次:在 Card 內,<onevent>、<timer>、<do> 三者必須依此順序書寫。
在 Deck 層級還可以加入 <template>,用來把事件綁定到整個 Deck 上:
<template onenterforward="url" onenterbackward="url" ontimer="url">
<do> 或 <onevent>
</template>
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "https://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<head>
<meta http-equiv="Cache-Control" content="max-age=0"/>
</head>
<template>
<do type="accept" label="deckPress" name="do1">
<go href="#card01"/>
</do>
</template>
<card id="card0" ordered="false">
<do type="accept" label="cardPress" name="do1">
<go href="#card02"/>
</do>
<p>Press ACCEPT...</p>
</card>
<card id="card01">
<p>Here is card01</p>
</card>
<card id="card02">
<p>Here is card02</p>
</card>
</wml>
這個例子示範了覆寫的優先順序:Deck 層級的 do1 指向 card01,而 card0 自己定義了同名的 do1 指向 card02,因此在 card0 上按下 ACCEPT 會跳到 card02,其他卡片則沿用 Deck 層級的設定。