jQM 頁面首次載入全量增強,動態內容需局部刷新。本文總結 ListView、Checkbox、Radio、Select、Slider、Flipswitch 等所有組件的刷新 API,附 AJAX 列表渲染實戰案例。
// 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 |
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();
}
}
});
}
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');
});
// 禁用
$('#mySelect').prop('disabled', true).selectmenu('refresh');
// 啟用
$('#mySelect').prop('disabled', false).selectmenu('refresh');
// 禁用樣式類 (供參考)
/*
*/
$('#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)。新項目建議:
<dialog>、<menu> 等新標準