以下內容是研讀過程中的筆記整理,依元件類別分項記錄常用屬性。
<link rel="stylesheet" href="https://code.jquery.com/mobile/1.3.2/jquery.mobile-1.3.2.min.css"> <script src="https://code.jquery.com/jquery-1.8.3.min.js"></script> <script src="https://code.jquery.com/mobile/1.3.2/jquery.mobile-1.3.2.min.js"></script>
三個基本角色:page(頁面容器,此屬性必須存在且位於最外層 div,否則事件會被重複註冊兩次)、header(頁首標題或選單區)、content(頁面內容)、footer(頁尾)。
<div data-role="page" id="pageone"> <div data-role="header"> <h1>在此處寫入標題</h1> </div> <div data-role="content"> <p>在此處寫入正文</p> </div> <div data-role="footer"> <h1>在此處寫入頁腳文本</h1> </div> </div>
全螢幕:要讓頁首頁尾固定不動,兩個 div 都要加上:
data-position="fixed" data-fullscreen="true"
這兩個屬性必須成對出現,只寫一個不會有效果。
標題置中:需在 header 或 footer 的下一層放 h1,其他標籤無效。
<div data-role="footer"> <h1>標題文字</h1> </div>
預設顯示第一個 page,其餘隱藏,用 a 的 href 指向對應 id 即可跳轉:
<div data-role="page" id="pageone"> <div data-role="content"> <a href="#pagetwo">轉到頁面二</a> </div> </div> <div data-role="page" id="pagetwo"> <div data-role="content"> <a href="#pageone">轉到頁面一</a> </div> </div>
對話框:加上 data-rel="dialog" 即可把目標頁呈現為對話框。要注意第一個 page 永遠是主體頁面,不會因這個屬性而變成對話框:
<div data-role="page" id="pageone"> <div data-role="content"> <a href="#pagetwo" data-rel="dialog">轉到對話框二</a> </div> </div> <div data-role="page" id="pagetwo"> <div data-role="header"> <h1>我是一個對話框!</h1> </div> <div data-role="content"> <p>對話框與普通頁面不同,它顯示在當前頁面的頂端。它不會橫跨整個頁面寬度。對話框頁眉中的圖標 “X” 可關閉對話框。</p> <a href="#pageone">轉到頁面一</a> </div> <div data-role="footer"> <h1>頁腳文本</h1> </div> </div>
在 a 標籤上指定:
data-transition="slide"
要反向播放加上:
data-direction="reverse"
可用的過場名稱:fade(預設,淡入淡出)、flip(由後向前翻頁)、flow(拋出當前頁並引入下一頁)、pop(彈出式)、slide(由右向左滑入)、slidefade(滑入並淡入)、slideup(由下向上)、slidedown(由上向下)、turn(轉向)、none(無效果)。
三種寫法:<button>、<input type="submit/reset/button"/>、<a data-role="button">(官方推薦)。
行內按鈕:預設一個按鈕佔一列,加上 data-inline="true" 可並排。
群組按鈕:
data-role="controlgroup" data-type="horizontal/vertical"
<div data-role="controlgroup" data-type="horizontal"> <p>水平分組:</p> <a href="#" data-role="button">按鈕 1</a> <a href="#" data-role="button">按鈕 2</a> <a href="#" data-role="button">按鈕 3</a> </div> <div data-role="controlgroup" data-type="vertical"> <p>垂直分組(默認):</p> <a href="#" data-role="button">按鈕 1</a> <a href="#" data-role="button">按鈕 2</a> <a href="#" data-role="button">按鈕 3</a> </div>
返回按鈕:data-rel="back",此時 href 會被忽略。
其他外觀屬性:data-corners 控制圓角(預設 true)、data-mini 控制是否為小按鈕(預設 false)、data-shadow 控制陰影(預設 true)。
加上 data-icon 即可,內建值包含 arrow-l(左箭頭)、arrow-r(右箭頭)、delete(刪除)、info(資訊)、home(首頁)、back(返回)、search(搜尋)、grid(網格)等。
位置用 data-iconpos="top/left/right/bottom",預設 left;只要圖示不要文字時設為 notext:
data-iconpos="notext"
頁首可於標題左右各放一個按鈕:
<div data-role="page"> <div data-role="header"> <a href="#" data-role="button" data-icon="home">首頁</a> <h1>歡迎訪問我的主頁</h1> <a href="#" data-role="button" data-icon="search">搜索</a> </div> </div>
只放一個按鈕時,無論寫在 h1 前或後都會靠左,想靠右需自行加上:
class="ui-btn-right"
頁首建議只放一到兩個按鈕,頁尾則無此限制。
頁尾與頁首不同,少了部分行內樣式且不會自動置中,需要置中的話在 footer 上加:
class="ui-btn"
頁尾也可使用群組排列:
<div data-role="footer" class="ui-btn" > <div data-role="controlgroup" data-type="horizontal"> <a href="#" data-role="button" data-icon="plus">轉播到新浪微博</a> <a href="#" data-role="button" data-icon="plus">轉播到騰訊微博</a> <a href="#" data-role="button" data-icon="plus">轉播到QQ空間</a> </div> </div>
定位方式:inline 為預設,頁首頁尾隨內容高度流動;fixed 會依捲動位置顯示或隱藏;fullscreen 需與 fixed 併用,讓頁首頁尾同時進出。
data-role="navbar"
navbar 內的 a 標籤不必再寫 data-role="button",框架會自動套用。
<div data-role="header"> <h1>標題 可不要</h1> <div data-role="navbar"> <ul> <li><a href="#a">首頁</a></li> <li><a href="#a">導航</a></li> <li><a href="#a">搜索</a></li> </ul> </div> </div>
預先啟用某一項用 class="ui-btn-active";點擊後保持啟用則用 class="ui-state-persist"。navbar 可放在 header、content 或 footer 中,層級須為 footer/header > navbar > ul > li > a。
data-role="collapsible"
<div data-role="collapsible"> <h1>標題</h1> <p>內容</p> </div>
預設收合,要預設展開加上 data-collapsed="false"。可折疊能任意嵌套,拿掉內容只留標題就是無限層級選單的基礎:
<div data-role="collapsible"> <h1>點擊我 - 我可以折疊!</h1> <p>我是被展開的內容。</p> <div data-role="collapsible"> <h1>點擊我 - 我是嵌套的可折疊塊!</h1> <p>我是嵌套的可折疊塊中被展開的內容。</p> </div> </div>
多個可折疊合成一組時,父層用 data-role="collapsible-set"、子層用 data-role="collapsible",同一時間只會展開一項:
<div data-role="collapsible-set"> <div data-role="collapsible"> <h3>點擊我 - 我可以折疊!</h3> <p>我是可折疊的內容。</p> </div> <div data-role="collapsible"> <h3>點擊我 - 我可以折疊!</h3> <p>我是可折疊的內容。</p> </div> <div data-role="collapsible"> <h3>點擊我 - 我可以折疊!</h3> <p>我是可折疊的內容。</p> </div> <div data-role="collapsible"> <h3>點擊我 - 我可以折疊!</h3> <p>我是可折疊的內容。</p> </div> </div>
其他屬性:data-inset="false" 去掉標題圓角、data-mini="true" 縮小按鈕、data-expanded-icon 更換展開時的圖示。
四種網格對應不同欄數:ui-grid-a 為兩欄各 50%、ui-grid-b 為三欄各約 33%、ui-grid-c 為四欄各 25%、ui-grid-d 為五欄各 20%。子元素依序使用 ui-block-a 到 ui-block-e。
要注意每換一個新的 ui-block-a 就會重新起一列,這是排版的依據。
在 ul 或 ol 上加 data-role="listview" 即可。
常用屬性:data-role="list-divider" 手動插入分隔標題;data-autodividers="true" 依字母自動分組;data-inset="true" 加上圓角內縮;data-filter="true" 開啟搜尋過濾;data-filter-placeholder 設定搜尋框的提示文字。
<ul data-role="listview" data-autodividers="true" data-inset="true" data-filter="true" data-filter-placeholder="搜索姓名 ..."> <li><a href="#">Adele</a></li> <li><a href="#">Agnes</a></li> <li><a href="#">Albert</a></li> <li><a href="#">Billy</a></li> <li><a href="#">Bob</a></li> <li><a href="#">Calvin</a></li> <li><a href="#">Cameron</a></li> <li><a href="#">Chloe</a></li> <li><a href="#">Christina</a></li> <li><a href="#">Diana</a></li> <li><a href="#">Gabriel</a></li> <li><a href="#">Glen</a></li> <li><a href="#">Ralph</a></li> <li><a href="#">Valarie</a></li> </ul>
去掉 li 裡的 a 標籤只留文字,就是只讀清單。
常見內容型態:
1. 含縮圖的清單:
<ul data-role="listview" data-inset="true"> <li> <a href="#"> <img src="/i/chrome.png"> <h2>Google Chrome</h2> <p>Google Chrome is a free, open-source web browser. Released in 2008.</p> </a> </li> <li> <a href="#"> <img src="/i/firefox.png"> <h2>Mozilla Firefox</h2> <p>Firefox is a web browser from Mozilla. Released in 2004.</p> </a> </li> </ul>
2. 清單圖示:16×16 的小圖加上 class="ui-li-icon" 即可,尺寸不符時沿用上一種寫法。
<li> <a href="#"> <img src="us.png" alt="USA" class="ui-li-icon"> USA </a> </li>
3. 分割按鈕:一個 li 內放兩個 a,第二個加上 data-rel="dialog" 就成了獨立的操作區。
<ul data-role="listview"> <li> <a href="#"><img src="chrome.png"></a> <a href="#download" data-rel="dialog">下載浏覽器</a> </li> </ul>
4. 計數標籤:在 a 內的 span 上加上 class="ui-li-count"。
<ul data-role="listview"> <li><a href="#">Inbox<span class="ui-li-count">335</span></a></li> <li><a href="#">Sent<span class="ui-li-count">123</span></a></li> <li><a href="#">Trash<span class="ui-li-count">7</span></a></li> </ul>
5. 自訂清單箭頭圖示:在 li 上加 data-icon="minus"。
6. 行事曆樣式:外層 listview,內含 list-divider 作為日期標題,其下接事件內容,右側可用 ui-li-aside 放摘要文字。
<ul data-role="listview" data-inset="true"> <li data-role="list-divider">星期三, 1 月 2 日, 2013 <span class="ui-li-count">2</span></li> <li><a href="#"> <h2>醫生</h2> <p><b>To Peter Griffin</b></p> <p>Well, Mr. Griffin, I've looked into physical results.</p> <p>Ah, Mr. Griffin, I'm not quite sure how to say this. Kim Bassinger? Bass singer? Bassinger?</p> <p>But now, onto the cancer</p> <p>You are a Cancer, right? You were born in July? Now onto these test results.</p> <p class="ui-li-aside">Re: Appointment</p></a> </li> <li><a href="#"> <h2>Glen Quagmire</h2> <p>Remember me this weekend!</p> <br> <p>- giggity giggity goo</p> <p class="ui-li-aside">Re: Camping</p></a> </li> </ul>