概 述php
JReduhtml
在上一篇博客中,咱們學習瞭如何使用Hbuilder建立一個APP,同時如何使用MUI搭建屬於本身的第一款APP,沒有學習的同窗能夠戳連接學習: http://www.cnblogs.com/jerehedu/p/7832808.html android
今天這篇博客,咱們繼續深刻學習MUI框架,主要學習這幾個方面:加載子頁面、頁面跳轉並傳值,底部選項卡的多種實現方式。ios
1、MUI加載子頁面 |
在mobile app開發過程當中,常常遇到卡頭卡尾的頁面,也就是說頭部和尾部保持不動,而只有中間區域能夠滾動,常見的就是新聞列表與詳情頁等狀況:web
如上圖所示,頭部和尾部不會跟着滾動,而是隻有中間列表區域正常滾動。但這種局部滾動,在android手機上會出現滾動不流暢的問題;數組
針對這個問題,mui的解決思路是:將須要滾動的區域經過單獨的webview實現,徹底使用原生滾動。也就是說,將頁面分爲主頁面和子頁面兩部分,主頁面只有頭部和尾部,而須要滾動的區域放置到子頁面中,並在mui.init()方法中加載。大約就是這麼一個效果:網絡
在上篇博客中,咱們介紹了mui.init()方法,這個方法主要用於mui頁面的初始化,進行頁面加載時的各類配置,接受一個對象類型的參數。app
那麼,在mui中加載子頁面很是簡單,只須要對象中傳入subpages屬性,用數組格式表示多個頁面,subpages數組的格式要求以下:框架
mui.init({ subpages:[{ url:your-subpage-url,//子頁面HTML地址,支持本地地址和網絡地址 id:your-subpage-id,//子頁面標誌 styles:{ top:subpage-top-position,//子頁面頂部位置 bottom:subpage-bottom-position,//子頁面底部位置 width:subpage-width,//子頁面寬度,默認爲100% height:subpage-height,//子頁面高度,默認爲100% ...... }, extras:{}//額外擴展參數 }] });
具體的實現步驟以下:ide
① 新建主頁面,只保留頭部和尾部
主頁面中輸入mHeader、mfooter便可快速生成頭尾
<header class="mui-bar mui-bar-nav"> <a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a> <h1 class="mui-title">在主頁面中加載子頁面</h1> </header> <nav class="mui-bar mui-bar-tab"> <a class="mui-tab-item mui-active"> <span class="mui-icon mui-icon-home"></span> <span class="mui-tab-label">首頁</span> </a> <a class="mui-tab-item"> <span class="mui-icon mui-icon-phone"></span> <span class="mui-tab-label">電話</span> </a> <a class="mui-tab-item"> <span class="mui-icon mui-icon-email"></span> <span class="mui-tab-label">郵件</span> </a> <a class="mui-tab-item"> <span class="mui-icon mui-icon-gear"></span> <span class="mui-tab-label">設置</span> </a> </nav>
② 新建子頁面,承載一個列表頁
子頁面中輸入mList,便可快速生成一個列表頁面。注意子頁面中無需頭部尾部,也無需將內容包裹在mBody中。
<ul class="mui-table-view"> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> Item 1 </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> Item 2 </a> </li> 。。。。。。 </ul>
③ 主頁面的mui.init()方法中加載子頁面
mui.init({ /* 在頁面的指定位置,加載子頁面,實現卡頭卡尾的效果 */ subpages:[{ url:"0101-ziye.html",//子頁面HTML地址,支持本地地址和網絡地址 id:"0101-ziye.html",//子頁面標誌 styles:{ top:"45px",//子頁面頂部位置(頂部選項卡默認高度45px) bottom:"51px",//子頁面底部位置(頂部導航欄默認高度51px) //width:100%,//子頁面寬度,默認爲100% //height:100%,//子頁面高度,默認爲100% }, // extras:{}//額外擴展參數,頁面傳值時使用 }] })
上述配置代碼的詳細解釋已經在註釋中說明,你們按照註釋內容配置便可,其中extras:{}用於頁面間傳值使用,下個章節講解。
2、 頁面間跳轉並傳值 |
在移動APP中,頁面之間的跳轉傳值是很是經常使用的,一種典型的應用就是重新聞列表頁點擊每一條新聞,將新聞的id傳遞到詳情頁顯示,例以下述狀況:
在這裏須要強調一下,雖然咱們使用MUI製做的APP也是有網頁組成,可是頁面之間跳轉儘可能不要使用超連接標籤<a></a>進行跳轉,MUI給咱們提供了更加好用並且性能更優的方式:mui.openWindow(),這個函數咱們在上篇博客中已經使用過,此處再也不贅述。
可是從效果圖能夠看到,咱們從列表頁跳轉到詳情頁時,標題上面的內容也在發生着變化,那麼咱們就須要用到另外一個函數:mui.openWindowWithTitle(),這個方法是對mui.openWindow()的擴展,支持nativeObj繪製標題欄,加快頁面展示。
這個函數是對mui.openWindow()的擴展,所以mui.openWindow()方法須要配置的參數,在這個方法中依然支持,同時這個方法要求傳入一個新對象,表示對標題欄的配置:
mui.openWindowWithTitle({ // mui.openWindow()方法的各類配置項,依然寫在這裏 },{ title:{//標題配置 text:"",//標題文字 }, back:{//左上角返回箭頭 image:{//圖片格式 base64Data:''//加載圖片的Base64編碼格式數據 base64Data 和 imgSRC 必須指定一個.不然不顯示返回箭頭 } } })
要實現頁面之間的跳轉傳值,首先要爲列表頁的全部list添加點擊事件,並獲取到每一個list的id,同時將ID傳入到詳情頁。 固然,這些操做都須要在mui.plusReady方法中寫入:
mui.plusReady(function(){ var arr = document.getElementsByTagName("a"); for(var i=0; i<arr.length; i++){ !function(i){ arr[i].addEventListener("tap",function(){ mui.openWindowWithTitle({ url:"0102-detail.html", id:"0102-detail.html", styles:{ }, extras:{ // 打開頁面的同時,向新頁面傳遞數據。 newsId : i } },{ //標題欄的背景色和底邊線配置 backgroundColor:"#C9302C", //bottomBorderColor:"#00ff00", title:{ //標題文字的內容和樣式配置 text:"新聞詳情"+(i+1), styles:{ color:"#FFFFFF", align:"center", family:"'Helvetica Neue',Helvetica,sans-serif", size:"20px", style:"normal", weight:"bold", } }, back:{ image:{ /*返回箭頭圖片可使用imgSrc,也可使用base64編碼*/ //imgSrc:"img/back.png" base64Data:"data:image/png;base64,……" } } }) }) }(i); } });
這裏面,除了mui.openWindowWithTitle()以外,還有一個重要的代碼:
extras:{ // 打開頁面的同時,向新頁面傳遞數據。 newsId : i }
這就是頁面之間傳值的關鍵所在,使用extras對象,將咱們須要傳遞給新頁面的數據以鍵值對的形式送達。
當列表頁當id傳給詳情頁之後,詳情頁接受就很簡單了,只須要先取到當前詳情頁的WebView,並從當前WebView中取到傳過來的newsId:
mui.plusReady(function(){ // 取到當前的webview //var slef = plus.webview.currentWebview(); // 經過webview的id,獲取指定的webview var slef = plus.webview.getWebviewById("0102-detail.html"); document.getElementById("num").innerText = slef.newsId+1; })
上述代碼能夠看到,取到當前WebView的方式有兩種,一種是直接取到當前WebView,一種是使用WebView的id得到指定的WebView。 無論哪一種方式取到,拿到WebView之後,就能夠直接以鍵取值。
3、底部選項卡切換頁面 |
底部選項卡的切換,能夠說是APP的標誌之一。 幾乎主流的全部APP,都會在底部有多個選項卡,能夠點擊切換不一樣頁面。而這個功能,MUI也很友好的給咱們提供了兩種方式:DIV模式和WebView模式。兩種模式的顯示效果差很少,以下圖可見:
顧名思義,DIV模式是將全部子頁面的內容,分別放置到主頁不一樣的DIV中,當咱們點擊主頁的不一樣選項卡時,切換不一樣DIV的顯示。 這種方式顯然要比加載子頁的方式快不少,可是也顯然不能承載不少佈局的頁面,畢竟要在一個主頁中寫入全部子頁面的代碼,顯得不太現實。
而WebView模式則是將全部子頁面都寫入到不一樣的子頁面中,再經過主頁鏈接到一塊兒,點擊不一樣的選項卡 ,加載不一樣的子頁面,顯然這種方式更符合咱們的預期和要求。
DIV模式的選項卡切換很是的簡單,無需一行JS代碼,直接使用HTML代碼便可實現代碼的切換:
<header class="mui-bar mui-bar-nav"> <a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a> <h1 class="mui-title">底部選項卡切換(Div模式)</h1> </header> <nav class="mui-bar mui-bar-tab"> <a class="mui-tab-item mui-active" href="#page1"> <span class="mui-icon mui-icon-home"></span> <span class="mui-tab-label">首頁</span> </a> <a class="mui-tab-item" href="#page2"> <span class="mui-icon mui-icon-phone"></span> <span class="mui-tab-label">電話</span> </a> <a class="mui-tab-item" href="#page3"> <span class="mui-icon mui-icon-email"></span> <span class="mui-tab-label">郵件</span> </a> <a class="mui-tab-item" href="#page4"> <span class="mui-icon mui-icon-gear"></span> <span class="mui-tab-label">設置</span> </a> </nav> <div class="mui-content"> <div id="page1" class="mui-control-content mui-active"> 這是第一個頁面 </div> <div id="page2" class="mui-control-content"> 這是第二個頁面 </div> <div id="page3" class="mui-control-content"> 這是第三個頁面 </div> <div id="page4" class="mui-control-content"> 這是第四個頁面 </div> </div>
代碼解釋:
這種方式的實現,只須要給表明每一個子頁面的div,添加mui-control-content類便可,同時用mui-active表示默認加載的第一個子頁。
寫好子頁DIV後,給每一個div起一個id,而且將這個id與底部選項卡中的每一個a標籤的href屬性相關聯,便可實現選項卡的切換。
使用WebView模式的選項卡切換,首先須要建立多個子頁面的HTML文件,而主頁中,只須要頭部和尾部便可,其餘功能交給JS操做:
<header class="mui-bar mui-bar-nav"> <a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a> <h1 class="mui-title" id="title">首頁</h1> </header> <nav class="mui-bar mui-bar-tab"> <a id="defaultTab" class="mui-tab-item mui-active" href="a.html"> <span class="mui-icon mui-icon-home"></span> <span class="mui-tab-label">首頁</span> </a> <a class="mui-tab-item" href="b.html"> <span class="mui-icon mui-icon-email"></span> <span class="mui-tab-label">消息</span> </a> <a class="mui-tab-item" href="c.html"> <span class="mui-icon mui-icon-contact"></span> <span class="mui-tab-label">通信錄</span> </a> <a class="mui-tab-item" href="d.html"> <span class="mui-icon mui-icon-gear"></span> <span class="mui-tab-label">設置</span> </a> </nav>
HTML代碼的簡潔,必然形成JS代碼的相對複雜,可是也很簡單,你們使用粘貼複製大法便可:
var subpages = ['a.html', 'b.html', 'c.html', 'd.html']; var subpage_style = { top: '45px', bottom: '51px' }; var aniShow = {}; //建立子頁面,首個選項卡頁面顯示,其它均隱藏; mui.plusReady(function() { var self = plus.webview.currentWebview(); for (var i = 0; i < 4; i++) { var temp = {}; var sub = plus.webview.create(subpages[i], subpages[i], subpage_style); if (i > 0) { sub.hide(); } /* 讓新建立的webview,追加合併到當前的窗口上。合併成一個窗口。 * 目的:將父子窗口合併成一個頁面,實現同開同關的效果。 避免點擊返回安監室,子頁面先關閉,而父頁面的頭部和尾部沒有關閉的BUG。 */ self.append(sub); } }); //當前激活選項 var activeTab = subpages[0]; var title = document.getElementById("title"); //選項卡點擊事件 mui('.mui-bar-tab').on('tap', 'a', function(e) { var targetTab = this.getAttribute('href'); if (targetTab == activeTab) { return; } //更換標題 title.innerHTML = this.querySelector('.mui-tab-label').innerHTML; //顯示目標選項卡 //若爲iOS平臺或非首次顯示,則直接顯示 if(mui.os.ios||aniShow[targetTab]){ plus.webview.show(targetTab); }else{ //不然,使用fade-in動畫,且保存變量 var temp = {}; temp[targetTab] = "true"; mui.extend(aniShow,temp); plus.webview.show(targetTab,"fade-in",300); } //隱藏當前; plus.webview.hide(activeTab); //更改當前活躍的選項卡 activeTab = targetTab; });
每一行代碼的詳細做用,均已在代碼註釋中詳細說明 ,可是對於不少新手同窗,可能理解起來依然存在必定的問題,因此貼心的傑小瑞老師準備了極大程度的簡化版本。
上面的代碼雖然功能強大,可是代碼雜亂,很不容易理解,咱們能夠在保留原來的HTML的基礎上,將JS代碼進行極大程度的簡化處理:
mui.plusReady(function(){ var pages = ["a.html","b.html","c.html","d.html"]; var arr = document.getElementsByClassName("mui-tab-item") var styles = { top:"45px", bottom:"51px" } var pageArr = []; var slef = plus.webview.currentWebview(); for(var i=0; i<arr.length; i++){ // 有幾個選項卡,須要建立幾個子頁面 var page = plus.webview.create(pages[i],pages[i],styles); pageArr.push(page); !function(i){ arr[i].addEventListener("tap",function(){ // 讓當前頁面(i)顯示,不是當前頁面隱藏 for(var j=0; j<pageArr.length; j++){ if(j!=i) pageArr[j].hide(); else pageArr[j].show(); } /* 讓新建立的webview,追加合併到當前的窗口上。合併成一個窗口。 * 目的:將父子窗口合併成一個頁面,實現同開同關的效果。 避免點擊返回安監室,子頁面先關閉,而父頁面的頭部和尾部沒有關閉的BUG。 */ slef.append(pageArr[i]); }) }(i); } // 默認觸發第0個選項卡的tap事件。 mui.trigger(arr[0],"tap"); });
怎麼樣,代碼是否是簡潔不少了呢?一塊兒來看看最終效果吧!!
好了,今天的內容就先到這了,下篇博客讓咱們繼續探討MUI的更高級功能吧!因爲博客描述有限,使用過程當中有任何問題,歡迎評論留言討論哦~~
若是須要源碼,請點擊下載連接進行下載。