萬盛學電腦網

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

JavaScript 動態創建 Table/Tr/Td 完整指南:從 DOM API 到模板引擎最佳實踐

場景:下拉選擇聯動動態渲染表格

選擇「成果類型」→ AJAX 獲取主題列表 → 動態生成複選框表格(4 列/行)。

原生 DOM API 實現(教學級)

// 獲取表格容器
const table = document.getElementById('zhutiTable');

// 清空現有行(倒序刪除避免索引偏移)
while (table.rows.length) {
  table.deleteRow(0);
}

// 數據模擬:[ [id, name], ... ]
const provinces = [
  [1, '主題一'], [2, '主題二'], [3, '主題三'], [4, '主題四'],
  [5, '主題五'], [6, '主題六']
];

// 每行 4 個單元格
const COLS_PER_ROW = 4;

provinces.forEach(([id, name], index) => {
  // 每 4 個創建新行
  if (index % COLS_PER_ROW === 0) {
    var row = table.insertRow(); // 自動追加到 tbody
  }
  
  const cell = row.insertCell();
  cell.innerHTML = `
    <label>
      <input type="checkbox" name="zhutiIds" value="${id}"> ${name}
    </label>
  `;
});

// 空數據提示
if (!provinces.length) {
  const row = table.insertRow();
  const cell = row.insertCell();
  cell.colSpan = COLS_PER_ROW;
  cell.textContent = '暫無主題列表';
  cell.style.color = 'red';
  cell.style.textAlign = 'center';
}

關鍵 DOM API 速查

方法作用返回值
table.insertRow(index?)插入行,省略索引則追加HTMLTableRowElement
row.insertCell(index?)插入單元格HTMLTableCellElement
table.deleteRow(index)刪除指定行void
row.deleteCell(index)刪除指定單元格void
table.rows所有行集合(HTMLCollection)即時集合
row.cells行內所有單元格集合即時集合

jQuery 版本(簡潔但效能稍弱)

const $table = $('#zhutiTable').empty(); // 清空內容

provinces.forEach(([id, name], i) => {
  if (i % 4 === 0) {
    $table.append('');
  }
  const $row = $table.find('tr:last');
  $row.append(`
    <td>
      <label><input type="checkbox" name="zhutiIds" value="${id}"> ${name}</label>
    </td>
  `);
});

if (!provinces.length) {
  $table.append('暫無主題列表</td></tr>');
}

現代最佳實踐:模板引擎 + 虛擬 DOM

方案 A:原生 Template 標籤(零依賴)

<template id="rowTemplate">
  <tr>
    <td><label><input type="checkbox" name="zhutiIds"> <span class="name"></span></label></td>
    <td><label><input type="checkbox" name="zhutiIds"> <span class="name"></span></label></td>
    <td><label><input type="checkbox" name="zhutiIds"> <span class="name"></span></label></td>
    <td><label><input type="checkbox" name="zhutiIds"> <span class="name"></span></label></td>
  </tr>
</template>

<script>
function renderTable(data) {
  const tbody = document.querySelector('#zhutiTable tbody') || 
                (() => { const t = document.createElement('tbody'); document.getElementById('zhutiTable').appendChild(t); return t; })();
  tbody.innerHTML = ''; // 清空
  
  const template = document.getElementById('rowTemplate').content;
  
  for (let i = 0; i < data.length; i += 4) {
    const clone = document.importNode(template, true);
    const tds = clone.querySelectorAll('td');
    
    for (let j = 0; j < 4; j++) {
      const idx = i + j;
      if (idx >= data.length) {
        tds[j].innerHTML = ''; // 填充空單元格
        continue;
      }
      const [id, name] = data[idx];
      const input = tds[j].querySelector('input');
      const span = tds[j].querySelector('.name');
      input.value = id;
      span.textContent = name;
    }
    tbody.appendChild(clone);
  }
}
</script>

方案 B:字串模板 + 批量 innerHTML(極致效能)

function renderTableFast(data) {
  const COLS = 4;
  let html = '';
  
  for (let i = 0; i < data.length; i += COLS) {
    html += '';
    for (let j = 0; j < COLS; j++) {
      const idx = i + j;
      if (idx < data.length) {
        const [id, name] = data[idx];
        html += ``;
      } else {
        html += '';
      }
    }
    html += '';
  }
  
  if (!data.length) {
    html = '暫無主題列表';
  }
  
  document.getElementById('zhutiTable').innerHTML = html;
}

// 簡單防 XSS 轉義
function escapeHtml(text) {
  const div = document.createElement('div');
  div.textContent = text;
  return div.innerHTML;
}

效能對比(1000 行 × 4 列)

方案耗時 (ms)記憶體可維護性
原生 DOM API~120低⭐⭐⭐ 繁瑣
jQuery append~200中⭐⭐⭐⭐ 簡潔
Template 標籤~80低⭐⭐⭐⭐⭐ 結構分離
字串模板 + innerHTML~30高(臨時字串)⭐⭐⭐ 需手工轉義
Vue/React 虛擬 DOM~50中⭐⭐⭐⭐⭐ 聲明式

安全警示:XSS 防範

所有動態插入 HTML 的方案**必須轉義用戶數據**!

// 通用轉義函數
const escapeHtml = (str) => String(str)
  .replace(/&/g, '&')
  .replace(//g, '>')
  .replace(/"/g, '"')
  .replace(/'/g, ''');

或使用成熟庫:DOMPurify、he、框架內置綁定(Vue v-text/React {text} 自動轉義)。

總結

  • 教學/簡單頁面:原生 DOM API 理解本質
  • jQuery 老項目:.empty() + .append() 維持一致
  • 現代無框架項目:<template> + importNode 結構分離、效能佳
  • 極致效能/大數據:字串拼接 + 單次 innerHTML(注意 XSS)
  • 框架項目:聲明式渲染,框架自動優化

選對工具,讓動態表格渲染既優雅又高效。

copyright © 萬盛學電腦網 all rights reserved