在開發後台管理系統時,常會遇到需要以表格呈現階層式資料(如 API 參數說明)的需求,且要帶有縮進以表達父子關係。本文記錄實作這類「帶縮進表格」的過程,方便日後查閱,也供有相同需求的朋友參考。
資料來源是一段描述參數階層的 JSON,每個節點含 name(參數名)、type(型別)、paramDesc(說明)、value(賦值說明)、comment(備註)與 childrenParam(子參數清單)等欄位。
做法是先遞迴遍歷 JSON,為每個節點計算其所有後代的總數(len),再據此決定縮進層級與儲存格跨行(rowspan),最後拼出 HTML 表格。
// 統計子節點數量:為每個節點增加 len 屬性
function dataFormatFn(data, flagI, b, c){
data.len = (data.childrenParam && data.childrenParam.length) || 1;
if (data.childrenParam){
for (var i = 0; i < data.childrenParam.length; i++) {
b++;
data.len += dataFormatFn(data.childrenParam[i], flagI + 1, b, c[i]);
}
return data.len;
} else {
return (data.childrenParam && data.childrenParam.length) || 0;
}
}
// 將 data 轉為帶縮進的 html
function jsontohtml(data, flagI, len){
var paramHtml = '';
// 依層級加上羅馬數字縮進符號
var nbspArr = ['', '<b> Ⅰ</b>', '<b> Ⅱ</b>', '<b> Ⅲ</b>'];
for (var i = 0; i < data.length; i++) {
var str2 = '';
var span = (10 - flagI);
if (i == 0 && flagI > 0 && len > 1){
str2 = '<td rowspan="' + len + '"></td>';
}
paramHtml += '<tr>' + str2
+ '<td colspan="' + span + '"><nobr>' + nbspArr[flagI] + data[i].name + '</nobr></td>'
+ '<td>' + data[i].type + '</td>'
+ '<td>' + data[i].paramDesc + '</td>'
+ '<td>' + data[i].value + '</td>'
+ '<td>' + data[i].comment + '</td>'
+ '</tr>';
if (data[i].childrenParam){
paramHtml += jsontohtml(data[i].childrenParam, flagI + 1, data[i].len);
}
}
return paramHtml;
}
最後把產生的 paramHtml 套入表格框架,寫入頁面的容器即可:
var html = '<table class="table table-bordered">'
+ '<thead><tr><th>參數英文名</th><th>參數類型</th>'
+ '<th>參數中文釋義</th><th>參數賦值說明</th><th>其它說明</th></tr></thead>'
+ '<tbody>' + paramHtml + '</tbody></table>';
$('#outParam dl').html(html);
關鍵在於「遞迴 + rowspan」的組合:透過 flagI 追蹤目前所處的階層來控制縮進,透過 len 計算跨行數以對齊父層儲存格,如此一來,多層次的階層資料便能轉成一張層次分明、易讀的表格。這套方法特別適合呈現 API 參數、組織結構或分類樹狀資料。