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 | 適用範圍 | 增量/全量 | 典型場景 |
|---|---|---|---|
$(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 | 同步 value | JS 修改 value 後 |
// 插入原始 HTML 字符串
$('#content').append('<a data-role="button">Dynamic Button</a>')
.trigger('create'); // 遞歸增強容器內所有組件
// 甚至可對不存在的標記觸發
$('<a data-role="button">New</a>').appendTo('#content').trigger('create');
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
}
function updateSelect(options) {
var $sel = $('#mySelect');
$sel.html(options.map(opt =>
'<option value="' + opt.value + '">' + opt.text + '</option>'
).join(''));
// 必須傳 true 強制重建,否則新選項不顯示
$sel.selectmenu('refresh', true);
}
// 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');
});
$('#rangeSlider').val(60).slider('refresh');
$('#flipSwitch').val('on').slider('refresh'); // flipswitch 也是 slider
// 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";
});
<ul> 調用 refresh。解決:先 $('ul').listview() 再 refresh。trigger('create')。解決:僅在首次插入後調用,或使用 enhanceWithin() (jQM 1.4+)。trigger('create') 全量掃描。解決:針對性調用組件 refresh。理解 jQM 渲染機制,不僅能維護老項目,更能啟發對組件生命週期的深度思考。