本文整理 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",也可以呼叫內建的 close 方法,例如 $('.ui-dialog').dialog('close')。
由於模態對話框是動態產生的臨時頁面,不會被寫入雜湊表,因此無法用後退鍵回到它。舉例來說:在 A 頁點連結打開 B 對話框,關閉後跳到 C 頁,此時按瀏覽器後退鍵會回到 A 頁,而不是 B 頁。
工具條主要用於 header、footer 等區域,用來承載頁面的業務功能。它分為標題(header bar)、頁腳(footer bar)與導航(nav bar)三種。
預設工具條以 inline 方式定位,相容性最好,在對腳本與 CSS 支援不佳的裝置上也有不錯的表現。另一種是 fixed 定位(也稱「靜態」定位),可讓工具條固定在螢幕頂部或底部,並接受點擊事件來顯示/隱藏,藉此把螢幕空間最大化利用。實作方式是在標題或頁腳區域加上 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";
如果你沒有採用標準結構建立標題區,框架就不會自動產生預設按鈕。
結構與標題容器幾乎相同,只要把 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>
如果需要一組連動的按鈕,可以這樣寫:
<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" 變成按鈕樣式。為了風格統一,框架會在載入時自動把表單類按鈕格式化為 jQuery Mobile 風格,不需再加 data-role。
<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 表單元素重新包裝了外觀,並針對觸控操作做了優化,頁面中的 form 元素會自動被渲染成 jQuery Mobile 風格。
表單的用法與原生 HTML 相同,一樣可以用 POST 或 GET 提交。但有個細節要特別注意:ID 命名。在常規規範中,同一頁面不允許出現重複 ID;而 jQuery Mobile 允許同一個 DOM 裡存在多個「頁面」,因此建議表單元素的 ID 在整個專案中保持唯一,避免因 ID 衝突引發錯誤。
預設框架會自動渲染標準頁面中的表單元素,渲染完成後就能用 jQuery 函式操作它們。若某些情況需要保留原生外觀,可以在 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>
如果需要在列表裡動態加入資料,必須在資料載入後呼叫 refresh() 讓列表更新:
$('ul').listview('refresh');
以上就是用 jQuery Mobile 構建界面的基礎規則。