MUI使用總結

最近項目中需要使用MUI做一個視頻播放的小功能。我就花時間研究了一下MUI。

MUI是一個使用JavaScript開發Android和IOS應用的前端框架。這篇文章將以知識樹的形式對MUI的使用做一個總結,一些官方文檔中的東西我都只大致提一下,如果需要詳細瞭解可以進入官方文檔瞭解詳情。

UI組件

組件部分不多說,詳情可以看官方文檔

小技巧:Dialog 組件正常情況下是無法解析HTML內容的,如果需要對Dialog 組件的內容進行定製可以將Dialog 的最後一個參數type設置爲'div'。

MUI選擇器

MUI的選擇器類似Jquery,主要有#id選擇器、.class選擇器 標籤選擇器,組合選擇器。

mui('#id')
mui('.class')
mui('input')
mui('p.class')

和Jquery一樣,如果想從mui選擇器選中的元素中取出原生的DOM元素,只需取出mui('#id')[0]即可。

MUI的常用方法

MUI並沒有像Jquery一樣豐富的方法,常用的方法並不多。

事件相關的方法

MUI對象方法

on(event, selector, handler) 批量綁定事件

one(event, selector, handler) 批量綁定事件但是隻生效一次

off([event][, selector]) 刪除事件

MUI靜態方法

trigger(element, event, data) 觸發事件

fire(target, event, data) 觸發自定義事件

原生事件監聽方法

addEventListener(event, handler) 單個DOM節點綁定事件

手勢事件

頁面相關方法

init(options)

頁面初始化設置。目前支持在mui.init方法中配置的功能包括:創建子頁面關閉頁面手勢事件配置預加載下拉刷新上拉加載設置系統狀態欄背景顏色

openWindow(options)

打開新頁面

back()

關閉當前頁面

其他工具方法

此部分官方文檔都寫得非常詳細,如果哪個方法不懂可以直接點擊連接跳轉至官方文檔詳細查看。

MUI對象方法

each(handler)

遍歷

MUI靜態方法

each(obj, handler)

遍歷

[extend([deep, ]target, obj1[,objN])](http://dev.dcloud.net.cn/mui/...

合併多個對象

later(func,delay)

setTimeOut封裝

scrollTo(ypos[,duration)](http://dev.dcloud.net.cn/mui/...

滾動窗口屏幕到指定位置,該方法是對window.scrollTo()方法在手機端的增強實現,可設定滾動動畫時間及滾動結束後的回調函數;鑑於手機屏幕大小,該方法僅可實現屏幕縱向滾動。

os

我們經常會有通過navigator.userAgent判斷當前運行環境的需求,mui對此進行了封裝,通過調用mui.os.XXX即可

  • plus(可以訪問的參數爲:)

    .plus:返回是否在 5+ App(包括流應用)運行

    .stream:返回是否爲流應用

  • Android(可以訪問的參數爲:)

    .android:返回是否爲安卓手機

    .version:安卓版本號

    .isBadAndroid:android非Chrome環境

  • iOS(可以訪問的參數爲:)

    .ios:返回是否爲蘋果設備

    .version:返回手機版本號

    .iphone:返回是否爲蘋果手機

    .ipad:返回是否爲ipad

  • Wechat(可以訪問的參數爲:)

    .wechat:返回是否在微信中運行

AJAX方法

類似JQuery主要由ajax(options)、post(url,params,callback)、get(url,params,callback),詳情可參考官方文檔

MUI插件方法

示例1:跳轉到圖片輪播的第二張圖片

mui('.mui-slider').slider().gotoItem(1);

示例2:重新開啓上拉加載

mui('#pullup-container').pullRefresh().refresh(true);

MUI適用場景說明

爲解決HTML5在低端Android機上的性能缺陷,mui引入了原生加速,其中最關鍵的就是webview控件,因此mui若要發揮其全部能力,需和5+ App配合適用,若脫離5+ App,mui功能會受限,主要涉及三個部分:

webview窗口相關

涉及webview的,除了5+App,其它所有手機瀏覽器及PC瀏覽器均無法使用,涉及功能點包括:

  • webview模式窗體動畫
  • 創建子窗口(除了爲解決區域滾動的常見雙webview場景,還涉及webview模式的選項卡等多webview場景)
  • webview模式的側滑菜單(也有div方式側滑菜單)
  • webview模式的tab選項卡(也有div方式選項卡)
  • nativeUI,如原生的警告框、確認框、popover、actionsheet、toast。這些也有HTML5的實現。
  • 預加載
  • 自定義事件

第三方擴展插件

涉及webview的,除了5+App,其它所有手機瀏覽器及PC瀏覽器均無法使用,目前主要包括:語音輸入;

Touch事件相關(注意pc瀏覽器沒有touch事件)

Touch事件相關的,手機端瀏覽器均可使用、pc端chrome模擬手機瀏覽器也可以正常使用。
但普通PC端瀏覽器因爲沒有touch事件,可以顯示控件但滑動操作功能會受限;涉及功能點包括:

  • 手勢事件
  • mui封裝的tap相關處理業務:摺疊面板、二級列表、二級選項卡;
  • mui封裝的swipe、drag相關處理業務:圖片輪播、可左右滑動的圖文表格、可左右滑動的9宮格、滑動觸發列表項菜單、可拖動式側滑菜單、下拉刷新和上拉加載、可拖動式選項卡
    【備註】:在PC端,大家將tap替換成click,將HTML5默認的Drag事件替換mui 的swipe和drag,就可以解決如上兩個問題。

除上述列出的功能點,其它mui功能,均可以在其它手機瀏覽器及PC服務端使用,所有CSS均不受影響。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章