專案裡需要一個「左邊那欄是標題」的表格,翻遍現成的函式庫都沒有合適的,於是就自己寫了一個。這個 LeftHeadGrid 就是成品。
一、左側欄位作為表頭呈現
二、支援多列、多表頭
三、固定表頭(捲動時不跑掉)
四、能夠設定標題
五、可以取得表格中的資料
六、支援 IE 與 Chrome
七、表格能依內容自適應並置中
<head runat="server">
<title>Grid 左側固定測試</title>
<script src="LeftHeadGrid.js"></script>
<link href="LeftHeadGrid.css" rel="stylesheet" type="text/css" />
</head>
<body>
<form id="form1" runat="server">
<div id="testdiv" align="center"></div>
</form>
<script type="text/javascript">
var test = new LeftHeadGrid({
id: "leftHeadGrid",
width: 800,
title: "danielinbiti",
perUnitWidth: 300,
rowHeads: [{
width: "60",
rowname: [{ name: "日期" }, { name: "數值" }]
}],
columnDatas: [{
width: [1, 1],
rows: [[10130501, 101011], [2, 3]]
}]
});
test.RenderTo("testdiv");
</script>
</body>
設定物件裡,rowHeads 描述左側表頭(可多層,每層給寬度與名稱陣列);columnDatas 描述資料(width 是各欄的比例權重、rows 是二維陣列);perUnitWidth 則是比例單位的實際像素數。
var LeftHeadGrid = function (config) {
this.rowHeads = config.rowHeads != null ? config.rowHeads : [];
this.columnDatas = config.columnDatas != null ? config.columnDatas : [];
this.width = config.width != null ? config.width : "";
this.id = config.id != null ? config.id : "TreGrid";
this.perUnitWidth = config.perUnitWidth != null ? config.perUnitWidth : 10;
this.innerWidth = 0;
this.innerLWidth = 0;
this.height = 0;
this.title = config.title != null ? config.title : "";
this.noDataStr = config.noDataStr != null ? config.noDataStr : "no data";
};
這段是典型的「設定物件 + 預設值」模式。用 != null 而非 || 判斷,是為了讓 0 與空字串這些合法值不會被誤當成「未提供」而套上預設。
LeftHeadGrid.prototype.createGrid = function () {
var totalwidth = 0;
var tableHtml = "<table>";
for (var i = 0; i < this.rowHeads.length; i++) {
var obj = this.rowHeads[i];
var width = obj.width;
totalwidth = totalwidth + parseInt(width);
var rownameobj = obj.rowname;
for (var j = 0; j < rownameobj.length; j++) {
var nameobj = rownameobj[j];
var cls = (j == rownameobj.length - 1) ? 'bluelast' : 'bluefirst';
tableHtml += "<tr><td class='" + cls + "' width='" + width + "px'>"
+ nameobj.name + "</td></tr>";
this.height = this.height + 40;
}
}
tableHtml += "</table>";
var headHtml = "<div class='leftheadcss' style='width:" + totalwidth + "px;'>"
+ tableHtml + "</div>";
this.innerLWidth = totalwidth;
this.innerWidth = this.width - totalwidth - 5;
return headHtml;
};
兩個設計值得注意:最下面一列用不同的 class(bluelast 對 bluefirst),讓表頭底邊能畫出分隔線;減 5 是預留邊框寬度,避免資料區與表頭區加起來超出容器而產生不必要的橫向捲軸。
LeftHeadGrid.prototype.RenderTo = function (divId) {
var headHtml = this.createGrid();
var html = "<div id='outframe' class='outframecss' style='width:" + this.width + "px;'>"
+ headHtml
+ "<div id='dataframe' class='dataframecss' style='width:" + this.innerWidth + "px;'>"
+ "<div id='leftgriddataview' class='innerdivcss'></div>"
+ "</div>"
+ "</div>";
html = "<div id='divtitle' class='grittitle' style='width:" + this.width
+ "px;height:30px'><big>" + this.title + "</big></div>" + html + "</div>";
document.getElementById(divId).innerHTML = html;
this.show();
};
結構是「標題層 + 外框」,外框裡左邊放表頭、右邊放資料區。表頭與資料是兩個獨立的 table,各自在自己的容器裡捲動——這正是「左側固定」能成立的關鍵:右邊的資料區獨立捲動時,左邊的表頭完全不動。
LeftHeadGrid.prototype.show = function () {
if (this.columnDatas && this.columnDatas.length > 0) {
var obj = this.columnDatas[0];
var widthArr = obj.width;
var rows = obj.rows;
var totalWidth = 0;
for (var i = 0; i < widthArr.length; i++) {
widthArr[i] = parseInt(widthArr[i]) * this.perUnitWidth; // 比例 → 實際像素
totalWidth = totalWidth + widthArr[i];
}
var tableHtml = "<table width='" + totalWidth + "'>";
for (var i = 0; i < rows.length; i++) {
var rowvalueArr = rows[i];
tableHtml += "<tr>";
for (var j = 0; j < rowvalueArr.length; j++) {
tableHtml += "<td width='" + widthArr[j] + "px'>" + rowvalueArr[j] + "</td>";
}
tableHtml += "</tr>";
}
tableHtml += "</table>";
// 內容比容器窄時,收縮外框並讓整體置中
if (this.innerWidth > totalWidth) {
document.getElementById("dataframe").style.width = parseInt(totalWidth) + "px";
document.getElementById("divtitle").style.width =
(parseInt(this.innerLWidth) + parseInt(totalWidth)) + "px";
document.getElementById("outframe").style.width =
(parseInt(this.innerLWidth) + parseInt(totalWidth) + 4) + "px";
}
document.getElementById("leftgriddataview").innerHTML = tableHtml;
} else {
document.getElementById("leftgriddataview").style.height = (this.height + 4) + "px";
document.getElementById("leftgriddataview").innerHTML = this.noDataStr;
}
};
widthArr[i] * this.perUnitWidth 把比例權重換成實際像素,這是「自適應」的核心:改 perUnitWidth 就能整體縮放,不必逐欄指定寬度。
最後那段 if 處理的是內容不足時的置中:若實際內容寬度小於容器,就把外框收縮到內容的實際寬度,配合外層 align="center" 讓它置中呈現。少了這步,表格會靠左貼邊、右側留一大片空白。
else 分支處理無資料的情況:把高度設為表頭的總高,讓空表格仍有合理的視覺高度,並顯示 noDataStr。這個細節常被忽略,但空表格塌成一條線是很難看的。
// 動態更新資料
LeftHeadGrid.prototype.addData = function (data) {
this.columnDatas = data;
this.show();
};
// 取出資料,每列組成一筆以逗號分隔的字串
LeftHeadGrid.prototype.getData = function () {
var rtnObj = new Array();
if (this.columnDatas && this.columnDatas.length > 0) {
var obj = this.columnDatas[0];
var rows = obj.rows;
for (var i = 0; i < rows.length; i++) {
var rowvalueArr = rows[i];
for (var j = 0; j < rowvalueArr.length; j++) {
if (j == 0) { rtnObj[i] = rowvalueArr[j]; }
else { rtnObj[i] = rtnObj[i] + "," + rowvalueArr[j]; }
}
}
}
return rtnObj;
};
// 取出表頭名稱
LeftHeadGrid.prototype.getHead = function () {
var rtnObj = new Array();
for (var i = 0; i < this.rowHeads.length; i++) {
var rownameobj = this.rowHeads[i].rowname;
for (var j = 0; j < rownameobj.length; j++) {
if (j == 0) { rtnObj[i] = rownameobj[j].name; }
else { rtnObj[i] = rtnObj[i] + "," + rownameobj[j].name; }
}
}
return rtnObj;
};
三個方法構成完整的生命週期:RenderTo 產生版面、addData 更新內容、getData 與 getHead 讀回資料。需要調整的地方都可以自行修改。
用 innerHTML 組字串:优点是實作直接、相容性最好;缺點是無法插入事件、且資料含特殊字元時會破壞 HTML。若欄位可能出現 <、& 等字元,必須先做轉義,否則版面會跑掉;若資料來源不可信,還會形成 XSS。
id 寫死:程式裡直接用 document.getElementById("dataframe") 等固定 id,代表同一頁面只能放一個實例。要支援多個,得把 id 加上 this.id 前綴。
左右兩個獨立 table 如何對齊:這是這類元件最脆弱的地方。左右各自用固定 px 寬度,一旦某欄內容過長而換行,兩邊的列高就會不同步。較穩健的做法是改用單一 table,用 CSS 的 position: sticky 讓第一欄固定:
th:first-child, td:first-child {
position: sticky;
left: 0;
background: #fff;
z-index: 1;
}
這樣只有一個 table,列高永遠對齊,也不必寫任何 JavaScript 來同步位置——是現代瀏覽器上處理「固定表頭欄」的首選方案。
可考慮的擴充:排序(點表頭切換升降序)、欄寬拖曳調整、選取列、忙碌狀態遮罩。這些加上去之後,其實就是在重新發明一個表格元件;若需求持續增加,評估 AG Grid、Handsontable 或 TanStack Table 這類成熟方案會更划算。