萬盛學電腦網

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

jQuery Mobile 動態元素渲染失效?核心 API 與最佳實踐全解析

jQuery Mobile (jQM) 初始化時會增強標準表單元素,動態插入的元素缺乏增強樣式。本文系統講解 trigger('create')、.listview('refresh')、.selectmenu('refresh') 等核心 API 的適用場景與差異。

為什麼動態元素不渲染?

jQM 在 pagecreate 階段掃描 data-role 屬性,為元素注入類、包裹標籤、綁定事件。動態插入的 HTML 未經此過程,保持原始樣貌。

<!-- 原始按鈕 -->
<a data-role="button">Click</a>

<!-- jQM 增強後 -->
<a data-role="button" class="ui-btn ui-btn-up-c ui-shadow ui-corner-all" ...>
  <span class="ui-btn-inner"><span class="ui-btn-text">Click</span></span>
</a>

核心 API 對比

API適用範圍增量/全量典型場景
$(container).trigger('create')任意容器內所有 jQM 組件全量增強頁面大區塊動態注入、AJAX 載入片段
$list.listview('refresh')已初始化的 ListView增量更新新 li列表追加/刪除項
$select.selectmenu('refresh', true)已初始化的 SelectMenu全量重建 (true)動態修改 option、啟用/禁用
$checkbox.checkboxradio('refresh')Checkbox/Checkboxradio同步 checked 狀態JS 修改 checked 屬性後
$slider.slider('refresh')Slider/Flipswitch同步 valueJS 修改 value 後

實戰場景代碼

1. 通用容器增強:trigger('create')

// 插入原始 HTML 字符串
$('#content').append('<a data-role="button">Dynamic Button</a>')
            .trigger('create'); // 遞歸增強容器內所有組件

// 甚至可對不存在的標記觸發
$('<a data-role="button">New</a>').appendTo('#content').trigger('create');

2. ListView 列表追加

function appendListItems(items) {
  var $ul = $('#myList');
  var html = items.map(item => 
    '<li><a href="#detail" data-id="' + item.id + '">' + item.name + '</a></li>'
  ).join('');
  
  $ul.append(html).listview('refresh'); // 僅增強新增的 li
}

3. Select 動態選項更新

function updateSelect(options) {
  var $sel = $('#mySelect');
  $sel.html(options.map(opt => 
    '<option value="' + opt.value + '">' + opt.text + '</option>'
  ).join(''));
  
  // 必須傳 true 強制重建,否則新選項不顯示
  $sel.selectmenu('refresh', true);
}

4. Checkbox/Radio 狀態同步

// JS 修改 checked 後必須 refresh
$('input[type="checkbox"]').prop('checked', true).checkboxradio('refresh');
$('input[type="radio"]').prop('checked', true).checkboxradio('refresh');

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

5. Slider/Flipswitch 同步

$('#rangeSlider').val(60).slider('refresh');
$('#flipSwitch').val('on').slider('refresh'); // flipswitch 也是 slider

禁用 jQM 自動增強

// 1. 單元素禁用
<input data-role="none" type="text">

// 2. 全局配置 (mobileinit 事件中,必須在引入 jQM 前)
$(document).on('mobileinit', function() {
  $.mobile.page.prototype.options.keepNative = 
    "select, input.foo, textarea.bar, .no-jqm";
});

常見錯誤與調試

  1. cannot call methods on listview prior to initialization:對未初始化的 <ul> 調用 refresh。解決:先 $('ul').listview() 再 refresh。
  2. 重複增強導致嵌套標籤:多次 trigger('create')。解決:僅在首次插入後調用,或使用 enhanceWithin() (jQM 1.4+)。
  3. 性能問題:大列表用 trigger('create') 全量掃描。解決:針對性調用組件 refresh。

現代替代:jQM 已停止維護,建議遷移方案

  • Framework7:iOS/Android 原生風格、Vue/React/Svelte 綁定
  • Ionic:Angular/React/Vue 生態、Capacitor 原生橋接
  • 原生 Web Components + CSS:輕量、無框架依賴

理解 jQM 渲染機制,不僅能維護老項目,更能啟發對組件生命週期的深度思考。

copyright © 萬盛學電腦網 all rights reserved