本節完整解析 WML 文件的各個組成部分。
<?XML version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"https://www.wapforum.org/DTD/wml_1.1.XML">
WML 首先定義一個 Deck,然後在 Deck 內封裝資訊與 Card。
頭資訊包含與 Deck 有關的資訊,包括 meta 數據與控制元素。
3.1 訪問權限設置(Access):用於設置有訪問當前 Deck 權限的列表。若 Deck 內不含 Access 元素,則該 Deck 下的 Access 元素處於無效狀態,其他所有 Deck 都可訪問該 Deck。
相關屬性:domain——例如設置 <Access domain="sina.com.cn"/>,則 https://www.sina.com.cn/ 有訪問權限,而 https://www.sino.com.cn/ 與 https://www.sina.net.cn/ 就沒有;path——原理與 domain 類似,例如設置 <Access path="/internal"/>,則 "/internal/wml" 會獲得訪問權限,而 "/internal-wml" 則不會。
範例:做如下設置 <Access domain="sina.com.cn" path="/wap"/>,那麼以下 URL 具有訪問權限:
https://www.sina.com.cn/wap/goto.CGI
https://www.sina.com.cn/wap/index.wml
https://www.sina.com.cn/wap/cgi-bin/create_report.CGI?name=123&pwd=234
而以下 URL 沒有訪問權限:
https://www.sina.com/wap/getuid.CGI
https://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 則每次都需連接伺服器調用。
<meta user-agent="vnd.up.markable" content="false"/> 與 <meta user-agent="vnd.up.bookmark" content="指定的URL"/> 類似於普通瀏覽器的書籤功能。當用戶將一個 Card 做了書籤後,手機瀏覽器會先用一個標記記錄該 Card(預設是 <card> 標籤中的 title 屬性),之後當用戶選擇該書籤時,瀏覽器就會打開被記錄的 URL。由於預設情況下手機會記錄所有 Deck,因此 <meta> 常被用來讓手機不要記錄當前 URL。
為了節省資源,可把每個 Card 都會用到的 Task 設定在模板中,供當前 Deck 中所有 Card 使用;若個別 Card 不需要該模板內容,可以 Override 掉它(詳見任務屏蔽)。
以下事件適用於 Card 與 Template:onenterbackward、onenterforward、ontimer。
卡片屬性:id——同一 Deck 內 Card 的唯一標識,可作為標籤被引用(如 #nextcard);title——卡片標題,不同瀏覽器處理方式不同,有的會顯示標題,有的為節省顯示區域會忽略標題;newcontext——預設值為 false,用來指示跳轉到本 Card 時手機是否清除以前保留的資訊(包括變數、堆疊歷史記錄、重設手機狀態等);ordered——布爾變數,聲明 Card 是否有序,通常用來開發自動播放的幻燈片效果。
<?XML version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"https://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>