本文把 HTML5(特別是 jQuery Mobile 體系)裡最常用到的頁面元素用法整理成一份清單:頁面切換動畫、模態對話框、工具條、標題與頁腳容器、導航、按鈕、表單與列表。做行動版網頁時,這些幾乎就是全部的基本積木。
用 data-transition 屬性即可定義頁面切換的動畫效果:
<a href="index.html" data-transition="pop">I'll pop</a>
可用參數:
slide:從右側向左滑入slideup:從底部向上滑入slidedown:從上向下滑入pop:從中心漸顯展開fade:漸顯flip:翻轉如果想在目標頁面顯示後退按鈕,可以在連結加上 data-direction="reverse",它的效果等同早期的 data-back="true"。
模態對話框是一種帶有圓角標題欄與關閉按鈕的「偽浮動層」,適合需要使用者專注處理的情境。任何結構化頁面都能透過 data-rel="dialog" 變成模態框:
<a href="foo.html" data-rel="dialog">Open dialog</a>
幾個實務重點:
data-transition,官方建議搭配 pop、slideup 或 flip 效果較自然。data-rel="back" 的連結當作關閉鈕。href="#" 或 data-rel="back" 關閉,也可以呼叫內建方法:$('.ui-dialog').dialog('close')。工具條主要用在 header、footer 等區域。可分為標題(header bar)、頁腳(footer bar)與導航(nav bar)三類。
定位方式有兩種:
data-position="fixed"。<div data-role="header"> <h1>Page Title</h1> </div>
頁面切換後,框架會自動在標題容器左側產生一個後退按鈕。若某些頁面不需要它,加上 data-backbtn="false" 即可停用:
<div data-role="header" data-position="inline" data-backbtn="false"> <a href="index.html" data-icon="delete">Cancel</a> <h1>Edit Contact</h1> <a href="index.html" data-icon="check">Save</a> </div>
停用自動後退鈕之後,左側位置就能拿來放自訂按鈕,右側則可放主要操作(例如儲存)。
想改後退鈕的文字,有兩種做法:
<!-- 方法一:屬性 --> data-back-btn-text="previous" <!-- 方法二:透過擴充覆寫全域預設值 --> $.mobile.page.prototype.options.backBtnText = "previous";
另外要注意:如果你沒有使用標準的 header 結構,框架不會自動產生任何預設按鈕。
結構與標題幾乎一樣,只要把 data-role 改成 footer:
<div data-role="footer"> <h4>Footer content</h4> </div>
頁腳比標題靈活得多:它不限制按鈕數量,也不會自動把按鈕推到左右兩端,而是從左到右順向排列。
加上 class="ui-bar" 就能把頁腳變成工具條,不需額外排版就能放進一排列整齊的按鈕:
<div data-role="footer" class="ui-bar"> <a href="index.html" data-role="button" data-icon="delete">Remove</a> <a href="index.html" data-role="button" data-icon="plus">Add</a> <a href="index.html" data-role="button" data-icon="arrow-u">Up</a> <a href="index.html" data-role="button" data-icon="arrow-d">Down</a> </div>
如果想要「一組連動的按鈕」視覺,用 controlgroup 包起來:
<div data-role="footer" class="ui-bar" data-position="inline">
<div data-role="controlgroup" data-type="horizontal">
<a href="index.html" data-icon="delete">Remove</a>
<a href="index.html" data-icon="plus">Add</a>
<a href="index.html" data-icon="arrow-u">Up</a>
<a href="index.html" data-icon="arrow-d">Down</a>
</div>
</div>
小技巧:用 data-id 屬性可讓多個頁面共用同一個頁腳,切頁時就不會閃動重繪。
導航容器每行最多容納 5 個按鈕,用一個帶 data-role="navbar" 的 div 包住即可:
<div data-role="footer">
<div data-role="navbar">
<ul>
<li><a href="a.html" class="ui-btn-active">One</a></li>
<li><a href="b.html">Two</a></li>
</ul>
</div>
<!-- /navbar -->
</div>
<!-- /footer -->
在目前的項目上加 class="ui-btn-active" 可標示啟用狀態。若按鈕超過 5 個,導航列會自動換行分配。
任何連結都能用 data-role="button" 變成按鈕樣式;而 form 內的原生按鈕則會在頁面載入時自動轉換為 jQuery Mobile 風格,不需額外加屬性。
<a href="index.html" data-role="button" data-icon="delete">Delete</a>
data-icon 用來指定框架內建的圖示;data-iconpos 則控制圖示與文字的相对位置:
right:圖示在文字右側top:圖示在文字上方bottom:圖示在文字下方notext:隱藏文字,只留圖示預設情況下按鈕會依螢幕寬度獨占一行。想讓多個按鈕並排,加上 data-inline="true":
<div data-inline="true"> <a href="index.html" data-role="button">Cancel</a> <a href="index.html" data-role="button" data-theme="b">Save</a> </div>
用 data-role="controlgroup" 可以把幾個按鈕以緊湊的群組方式呈現:
<div data-role="controlgroup"> <a href="index.html" data-role="button">Yes</a> <a href="index.html" data-role="button">No</a> <a href="index.html" data-role="button">Maybe</a> </div>
加上 data-type="horizontal" 即可改為水平排列。
框架會把原生 HTML 表單元素重新包裝成適合觸控操作的樣式,但提交方式仍與原生相同,可用 POST 或 GET。
這裡有個容易忽略的問題:一般的 HTML 規範不允許同一頁面出現重複的 ID,但 jQuery Mobile 允許同一個 DOM 裡存在多個「頁面」,因此建議 表單元素的 ID 在整個專案範圍內保持唯一,否則跨頁取得元素時很容易出錯。
如果某些元素你就是想保留原生外觀,加上 data-role="none" 即可跳過框架的自動渲染:
<select name="foo" id="foo" data-role="none"> <option value="a">A</option> <option value="b">B</option> <option value="c">C</option> </select>
列表是行動版開發裡出現頻率最高的元件,常用於資料顯示、導航與清單。結構上沿用 ul/ol,只要加上 data-role="listview":
<ul data-role="listview" data-theme="g"> <li><a href="acura.html">Acura</a></li> <li><a href="audi.html">Audi</a></li> <li><a href="bmw.html">BMW</a></li> </ul>
如果是透過 AJAX 動態插入資料,記得在資料載入後呼叫 refresh 讓框架重算樣式:
$('ul').listview('refresh');
這一步經常被遺漏,導致新加入的項目沒有分隔線、沒有正確的內距,看起來就像壞掉一樣。
以上就是用 HTML5/jQuery Mobile 建構界面的核心規則。掌握「用 data-role 描述元件、用 data-* 屬性調整行為」這個思路,其餘元件都能很快上手。