jQuery 提供兩個主要方法將 HTML 內容寫入元素:.html() 替換全部內容,.append() 在現有內容後追加。
// 定義 HTML 字串
var navHtml = "<div style='width:145px;height:62px;float:left;background:url(login_image/index/on_1.jpg);font-size:18px;color:white;line-height:65px;' id='left_tab_1'>標籤內容</div>";
// 寫入目標容器
$('#top_1').html(navHtml);
// 追加而不覆蓋原有內容
$('#container').append('<p>新增的段落</p>');
// 批次追加多個元素
var items = '';
for (var i = 1; i <= 5; i++) {
items += '<div class="item">項目 ' + i + '</div>';
}
$('#list').append(items);
若 HTML 字串包含使用者輸入資料,務必進行轉義或使用 .text() 代替:
// 危險:直接插入未過濾的使用者輸入
$('#output').html(userInput); // 可能執行惡意腳本
// 安全:使用 .text() 自動轉義 HTML 實體
$('#output').text(userInput);
// 或手動轉義後再用 .html()
function escapeHtml(text) {
var map = {'&': '&', '<': '<', '>': '>', '"': '"', "'": '''};
return text.replace(/[&<>"']/g, function(m) { return map[m]; });
}
$('#output').html(escapeHtml(userInput));
大量 DOM 操作時,使用 DocumentFragment 減少重排重繪:
var fragment = document.createDocumentFragment();
var container = $('#data-list')[0];
for (var i = 0; i < 1000; i++) {
var div = document.createElement('div');
div.className = 'data-row';
div.textContent = '資料列 ' + i;
fragment.appendChild(div);
}
container.appendChild(fragment);
// 或 jQuery 寫法
$('#data-list').append(fragment);
function renderTable(data) {
var rows = data.map(function(item) {
return '<tr>' +
'<td>' + item.id + '</td>' +
'<td>' + item.name + '</td>' +
'<td>' + item.email + '</td>' +
'<td><button class="btn-edit" data-id="' + item.id + '">編輯</button></td>' +
'</tr>';
}).join('');
$('#data-table tbody').html(rows);
}
// 事件委派處理動態新增的按鈕
$('#data-table').on('click', '.btn-edit', function() {
var id = $(this).data('id');
editItem(id);
});
| 問題 | 原因 | 解決方案 |
|---|---|---|
| HTML 不顯示 | 選擇器錯誤或元素未載入 | 確認 ID 拼寫,包裹在 $(document).ready() 中 |
| 事件不觸發 | 動態元素未綁定事件 | 使用事件委派 $(parent).on('click', '.child', fn) |
| 樣式失效 | CSS 選擇器優先權不足 | 檢查 CSS 專用度,或使用 !important |
| 換行符消失 | HTML 忽略換行 | 使用 <br> 或 CSS white-space: pre-wrap |
使用 .html() 替換容器內容,.append() 追加內容。處理使用者輸入時務必防範 XSS。大量資料渲染時善用 DocumentFragment 或字串拼接後一次寫入,提升效能。動態新增的元素事件請使用事件委派機制綁定。