DIV CSS 佈局教程網

jQuery Mobile 局部渲染刷新大全:listview、checkbox、select 與 slider
編輯:JavaScript綜合知識     

jQuery Mobile 在首次載入時進行整頁渲染,之後動態產生的內容都必須手動觸發局部渲染,否則畫面會出現未經樣式增強的裸元素。以下按元件整理各自的刷新方式。

一、listview 局部渲染

典型的 AJAX 取資料後組清單:

function queryPublishOrderList(trackOrDealOrInsp, userCode, type, pageNum) {
    var url = "https://xxx.xxx.xxx.xxx/Myapp/WorkOrderSelByTypeService.svc"
            + "/WorkOrderSimpleByType/Json/" + trackOrDealOrInsp
            + "/" + userCode + "/" + type + "/" + pageNum;

    $.ajax({
        type: 'get',
        dataType: 'json',
        url: url,
        contentType: 'application/json',
        success: function (data) {
            var sb = [];
            $.each(data, function (i, item) {
                sb.push("<ul data-role='listview' data-inset='true' data-theme='c'>");
                sb.push("<li data-role='list-divider'>" + item.work_orders_id
                     + "<span class='ui-li-count'>" + i + "</span></li>");
                sb.push("<li><a href='inspectorder.html'>");
                sb.push("<p><label>工單號:</label><span>" + item.work_orders_id + "</span></p>");
                sb.push("<p><label>創建人:</label><span>" + item.founder_na + "</span></p>");
                sb.push("<p><label>創建時間:</label><span>" + item.found_time + "</span></p>");
                sb.push("</a></li></ul>");
            });
            $("#queryList").html(sb.join(''));
        },
        error: function () { alert("請求遠程服務錯誤!"); },
        complete: function () {
            $("div[data-role=content] ul").listview();
        }
    });
}

三種呼叫方式的差異:

  • $(sel).listview():初始化尚未增強的 listview。
  • $(sel).listview('refresh'):對已初始化的 listview 做增量更新,只處理新加入的項目。
  • 對未初始化的元素呼叫 refresh 會報錯:cannot call methods on listview prior to initialization; attempted to call method 'refresh'。

二、checkbox 必須刷新才能取到正確值

登入表單常有「記住帳號 / 記住密碼」兩個 checkbox。jQuery Mobile 會把原生 checkbox 隱藏起來,改用自訂元素呈現,因此程式改動 checked 屬性後,畫面不會同步。

// 使用者點擊後及時同步
$('input[type="checkbox"]').bind('click', function () {
    $(this).attr('checked', true).checkboxradio("refresh");
});

// 用程式改變值時同樣要刷新
$('input[type="checkbox"]').attr('checked', false).checkboxradio("refresh");

原因很單純:jQuery Mobile 把表單元素隱藏並覆蓋自訂樣式,程式改值後不通知它,畫面顯示的狀態就與實際值不一致。

三、其他元件的刷新寫法

// 下拉選單(第二個參數 true 表示同時重繪選單)
$("#selectbox").html(optionList).selectmenu('refresh', true);

// 複選框
$("input[type='checkbox']").attr("checked", true).checkboxradio("refresh");

// 單選鈕組
$("input[type='radio']").attr("checked", true).checkboxradio("refresh");

// 選擇列表
var myselect = $("select#foo");
myselect[0].selectedIndex = 3;
myselect.selectmenu("refresh");

// 滑桿
$("input[type=range]").val(60).slider("refresh");

// 開關(本質是 slider)
var myswitch = $("select#bar");
myswitch[0].selectedIndex = 1;
myswitch.slider("refresh");

四、禁用狀態的樣式

<select id="select-choice-1" disabled="disabled"
        class="mobile-selectmenu-disabled ui-state-disabled" aria-disabled="true">
    <option value="standard">Standard: 7 day</option>
    <option value="rush">Rush: 3 days</option>
</select>

<input type="button" disabled="disabled" value="不可用"
       class="ui-btn-hidden mobile-button-disabled ui-state-disabled" aria-disabled="true">

實務上更推薦用 jQuery Mobile 的 API 而非手動加 class:

$("#select-choice-1").selectmenu('disable');
$("input#myBtn").button('disable');

五、實務要點整理

  • refresh 只能用在已初始化的元素上,未初始化請改用 .trigger('create') 或直接呼叫元件建構。
  • 迴圈外再一次刷新:迴圈中逐筆 refresh 會造成大量重複計算,是常見效能問題。
  • 整批替換先清空:用 .empty() 清掉舊內容再 append,最後 refresh。
  • 拼接 HTML 務必轉義:範例中把資料直接組進 HTML 字串,若來源不可信會有 XSS 風險,應改用 text() 設定文字或先做實體編碼。
  • 陣列取代字串拼接:範例中用陣列 push 再 join,比 += 反覆拼接字串更有效率。

一句話總結:jQuery Mobile 的元件狀態是「渲染時快照」,任何程式層級的變更都要用對應的 refresh 方法同步回去。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved