萬盛學電腦網

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

jQuery 動態將 HTML 字串寫入 DIV 容器完整教學

核心方法:.html() 與 .append()

jQuery 提供兩個主要方法將 HTML 內容寫入元素:.html() 替換全部內容,.append() 在現有內容後追加。

基本用法:.html() 替換內容

// 定義 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);

進階用法:.append() 追加內容

// 追加而不覆蓋原有內容
$('#container').append('<p>新增的段落</p>');

// 批次追加多個元素
var items = '';
for (var i = 1; i <= 5; i++) {
  items += '<div class="item">項目 ' + i + '</div>';
}
$('#list').append(items);

安全性考量:防止 XSS 攻擊

若 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));

效能優化:DocumentFragment 批次操作

大量 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 或字串拼接後一次寫入,提升效能。動態新增的元素事件請使用事件委派機制綁定。

copyright © 萬盛學電腦網 all rights reserved