萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Mobile 局部渲染刷新大全:ListView、表單組件、導航欄一網打盡

jQM 頁面首次載入全量增強,動態內容需局部刷新。本文總結 ListView、Checkbox、Radio、Select、Slider、Flipswitch 等所有組件的刷新 API,附 AJAX 列表渲染實戰案例。

ListView 刷新策略

// 1. 容器首次初始化 (僅需一次)
$('#myList').listview();

// 2. 追加新 li 後增量刷新
$('#myList').append(newItemsHtml).listview('refresh');

// 3. 直接操作 li 刷新 (較少用)
$('#myList li').listview('refresh'); // 錯誤!li 本身不是 listview

// ⚠️ 常見錯誤:未初始化直接 refresh
// Uncaught Error: cannot call methods on listview prior to initialization
// 修正:先初始化再 refresh
$('#myList').listview().listview('refresh');

表單組件刷新速查表

組件刷新方法典型觸發場景
Checkbox.checkboxradio('refresh')JS 修改 prop('checked', true/false) 後
Radio.checkboxradio('refresh')JS 修改 prop('checked', true) 後
Select (原生).selectmenu('refresh')動態修改 <option>、改變 selectedIndex
Select (多選).selectmenu('refresh', true)同上,true 強制重建
Slider / Range.slider('refresh')JS 修改 .val() 後
Flipswitch.slider('refresh')本質是 slider,同 slider
Textinput / Textarea無需刷新原生輸入框無增強包裹
Button.button('refresh')動態修改 disabled、icon、text

實戰:AJAX 載入列表並正確渲染

function loadOrderList(page) {
  $.ajax({
    url: '/api/orders',
    data: {page: page},
    dataType: 'json',
    success: function(data) {
      var html = '';
      $.each(data.list, function(i, item) {
        html += '<ul data-role="listview" data-inset="true">';
        html += '<li data-role="list-divider">' + item.id + '</li>';
        html += '<li><a href="#detail" data-id="' + item.id + '">';
        html += '<p><strong>創建人:</strong> ' + item.creator + '</p>';
        html += '<p><strong>時間:</strong> ' + item.time + '</p>';
        html += '</a></li>';
        html += '</ul>';
      });
      
      // 關鍵:html() 替換內容後,調用 listview() 初始化 (首次) 或 refresh (後續)
      var $container = $('#orderContainer');
      $container.html(html);
      
      // 判斷是否已初始化
      if ($container.find('ul').hasClass('ui-listview')) {
        $container.find('ul').listview('refresh');
      } else {
        $container.find('ul').listview();
      }
    }
  });
}

Checkbox/Radio 狀態不同步問題根因

jQM 隱藏原生 <input>,創建 <div class="ui-checkbox"> 模擬視覺。JS 直接修改 input.checked 不會觸發模擬層更新。

// 錯誤
$('input[type=checkbox]').prop('checked', true); // 視覺不變

// 正確
$('input[type=checkbox]').prop('checked', true).checkboxradio('refresh');

// 事件綁定自動同步 (推薦)
$(document).on('change', 'input[type=checkbox]', function() {
  $(this).checkboxradio('refresh');
});

Select 禁用/啟用狀態同步

// 禁用
$('#mySelect').prop('disabled', true).selectmenu('refresh');

// 啟用
$('#mySelect').prop('disabled', false).selectmenu('refresh');

// 禁用樣式類 (供參考)
/*

*/

Button 禁用狀態同步

$('#myBtn').prop('disabled', true).button('refresh');
// 對應類:ui-btn-hidden mobile-button-disabled ui-state-disabled

統一刷新工具函數

$.fn.jqmRefresh = function() {
  return this.each(function() {
    var $el = $(this);
    var role = $el.data('role') || $el.attr('data-role');
    
    switch (role) {
      case 'listview': $el.listview('refresh'); break;
      case 'slider': $el.slider('refresh'); break;
      case 'flipswitch': $el.slider('refresh'); break;
    }
    
    // 表單元素統一處理
    if ($el.is('input, select, textarea')) {
      if ($el.is('[type=checkbox], [type=radio]')) $el.checkboxradio('refresh');
      else if ($el.is('select')) $el.selectmenu('refresh', true);
      else if ($el.is('[type=range]')) $el.slider('refresh');
      else if ($el.is('[data-role=button]')) $el.button('refresh');
    }
    
    // 容器遞歸增強
    $el.find('[data-role]').each(function() {
      $(this).jqmRefresh();
    });
  });
};

// 一鍵刷新整個容器
$('#dynamicContent').jqmRefresh();

遷移提示

jQM 官方已停止維護 (2021 年最後版本 1.4.5)。新項目建議:

  • 移動端 H5:Vant、NutUI、TDesign (Vue/React)
  • 混合應用:Ionic (Capacitor)、Framework7
  • 輕量項目:原生 CSS + <dialog>、<menu> 等新標準
copyright © 萬盛學電腦網 all rights reserved