這個範例實作了兩個常見需求:捲動時表頭固定不動,以及用滑鼠拖曳邊界調整欄寬。整個實作以 jQuery 為基礎,拆成兩個獨立的 IIFE。
<DOCTYPE html>
<html>
<head>
<title></title>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
<style>
body { font: 12px/1.5 Tahoma; }
#gannt_left { width: 500px; }
#left-scroll-panel {
width: 520px;
height: 100px;
overflow-y: auto;
}
table {
table-layout: fixed;
border-collapse: collapse;
border-spacing: 0px;
text-align: center;
width: 500px;
}
table, th, td { border: 1px solid #afe0ea; }
th, td {
height: 20px;
line-height: 20px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
word-wrap: normal;
word-break: keep-all;
}
th { background: #adf5ff; }
td { background: #f6fcff; }
#gannt_grid, #gannt_grid td { border-top: 0px none; }
</style>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
</head>
<body>
<div id="gannt_left">
<div id="left-scroll-panel" class="scroll-panel">
<table id="gannt_grid">
<thead>
<tr>
<th width="30">序號</th>
<th width="35">操作</th>
<th>標題</th>
<th width="80">執行人</th>
<th width="80">開始時間</th>
<th width="80">結束時間</th>
<th width="30">天數</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td><td>編輯</td><td>任務標題:阿斯卡是大家啊</td>
<td>Firefox</td><td>2012-07-15</td><td>2012-08-15</td><td>32</td>
</tr>
<!-- 其餘列省略 -->
</tbody>
</table>
</div>
</div>
CSS 上有幾個要點:table-layout: fixed 讓欄寬聽從 width 設定而非內容;overflow: hidden 搭配 text-overflow: ellipsis 讓過長內容截斷顯示省略號;border-collapse: collapse 讓相鄰邊框合併,拖動時視覺才乾淨。
(function () {
var leftScrollPanel = $("#left-scroll-panel");
var ganntBody = $("#gannt_grid>tbody");
var fixedThead = leftScrollPanel.prev(".fixed-header-tb");
if (!fixedThead.length) {
fixedThead = $('<table class="fixed-header-tb"></table>');
fixedThead.append(ganntBody.prev()); // 把 thead 搬到獨立表格
leftScrollPanel.before(fixedThead);
} else {
// 表格重繪時不要重複建立表頭
ganntBody.prev().remove();
}
var tds = ganntBody.find("tr:first>td");
var ths = fixedThead.find("th");
var thWidth;
$.each(tds, function (index, td) {
// jq 的 width() 或 css('width') 可能有 1px 誤差,直接用 attr 讀 width
thWidth = ths.eq(index).attr("width");
(thWidth != undefined) && $(td).attr("width", thWidth);
});
})();
思路是把 thead 從原表格中抽出,放到滾動容器外面的一個獨立 table。因為它在容器之外,垂直捲動時自然不會跟著跑。
那段 $.each 是在同步首列的寬度設定。註解裡提到的 1px 誤差是實務上常見的困擾:jQuery.width() 回傳的是 computed style 換算後的數值,與 HTML width 屬性可能有微小落差,所以直接讀 attr 更保險。
(function () {
var sideOffset = {
left: null, right: null, td: null,
tdLocked: null, tdLeft: null, tdRight: null
};
var pos = { resizedTime: 0, beginPos: 0 };
var tableHead = $(".fixed-header-tb").find("tr:first");
var headCellTagName = "th";
var bodyHead = $("#gannt_grid>tbody").find("tr:first");
var minInterVal = 0; // 拖曳觸發的最小時間間隔(節流用)
var minWidth = 30; // 欄的最小寬度
var borderBeside = 5; // 判定滑鼠是否在邊界附近的閾值
var notResizeCells = [0, 1, 6]; // 不允許拖曳的欄(序號、操作、天數)
var freeCells = [2]; // 自適應寬度的欄(標題)
var forceSize = false;
var resizeAllow = false;
var resizing = false;
幾個常數的設計意圖很明確:notResizeCells 排除了固定寬度的窄欄,拖動它們沒有意義;freeCells 則是「吃掉剩餘空間」的彈性欄,拖動其他欄時由它吸收差值;minWidth 防止欄被拖到消失。
var forbiddenResize = function () {
var frag = false;
var o = sideOffset;
var index = o.td.index();
if ($.inArray(index, notResizeCells) > -1) {
frag = true;
} else if ((index == 0 || $.inArray(index - 1, notResizeCells) > -1) && o.left <= borderBeside) {
frag = true;
} else if ((index == o.td.siblings().length || $.inArray(index + 1, notResizeCells) > -1) && o.right <= borderBeside) {
frag = true;
} else if (o.left > borderBeside && o.right > borderBeside) {
frag = true;
}
return frag;
};
var stopResize = function () {
if (!resizing) { return; }
resizing = false;
resizeAllow = false;
sideOffset = {
left: null, right: null, td: null,
tdLocked: null, tdLeft: null, tdRight: null
};
};
var isFreeCell = function (td) {
return forceSize == false && $.inArray(td.index(), freeCells) != -1;
};
forbiddenResize 是這段程式最聰明的地方。拖動一條邊界,本質上是「左欄變窄、右欄變寬」的零和遊戲。這個函數判斷的是:拖這條邊界會不會撞到不可調整的欄。滑鼠在格子中央(左右距離都大於閾值)時不啟動拖曳,只有靠近邊界才允許;若邊界另一側是 notResizeCells 中的欄,也拒絕。
tableHead.bind({
mousemove: function (e) {
var th = $(e.target).closest(headCellTagName);
if (!th.length) { return; }
if (!resizing) {
sideOffset.td = th;
sideOffset.left = e.pageX - th.offset().left;
sideOffset.right = th.width() - (e.pageX - th.offset().left);
if (forbiddenResize()) {
resizeAllow = false;
sideOffset.td.css("cursor", "default");
} else {
resizeAllow = true;
sideOffset.td.css("cursor", "e-resize");
pos.resizedTime = new Date() * 1;
pos.beginPos = e.pageX;
}
return;
}
if (sideOffset.tdLocked) { th = sideOffset.tdLocked; }
if (new Date() - pos.resizedTime < minInterVal) { return; }
else { pos.resizedTime = new Date() * 1; }
var offset = (e.pageX - pos.beginPos);
if (!offset) { return; } else { pos.beginPos = e.pageX; }
var leftWidth = sideOffset.tdLeft.width();
var rightWidth = sideOffset.tdRight.width();
if (offset < 0 && leftWidth == minWidth) { return; }
else if (offset > 0 && rightWidth == minWidth) { return; }
var fixedLWidth, fixedRWidth;
if (leftWidth - Math.abs(offset) < minWidth && offset < 0) {
fixedLWidth = minWidth;
fixedRWidth = rightWidth - (minWidth - leftWidth);
} else if (rightWidth - offset < minWidth && offset > 0) {
fixedRWidth = minWidth;
fixedLWidth = leftWidth - (minWidth - rightWidth);
} else {
fixedLWidth = leftWidth + offset;
fixedRWidth = rightWidth - offset;
}
var adjustCells = [
{ cell: sideOffset.tdLeft, width: fixedLWidth },
{ cell: sideOffset.tdRight, width: fixedRWidth }
];
if (offset < 0) { adjustCells = adjustCells.reverse(); }
var inOneTable = bodyHead.parents("table:first").get(0) == tableHead.parents("table:first").get(0);
$.each(adjustCells, function (i, cellConf) {
if (isFreeCell(cellConf.cell)) { return; }
cellConf.cell.attr("width", cellConf.width);
if (!inOneTable) {
bodyHead.children().eq(cellConf.cell.index()).attr("width", cellConf.width);
}
});
},
mousedown: function () {
if (!resizeAllow) { return; }
sideOffset.tdLocked = sideOffset.td;
if (sideOffset.left <= 5) {
sideOffset.tdRight = sideOffset.td;
sideOffset.tdLeft = sideOffset.td.prev();
} else {
sideOffset.tdRight = sideOffset.td.next();
sideOffset.tdLeft = sideOffset.td;
}
resizing = true;
return false;
}
});
$(document).bind("mouseup", stopResize);
})();
拖曳邏輯的關鍵細節:
一是以位移量而非絕對座標計算。每次 mousemove 只取相對於上次的增量 offset,然後累加到當前寬度上。這樣即使滑鼠移出格子再移回來,也不會跳動。
二是邊界約束。當拖動會使某側寬度低於 minWidth 時,把該側鎖定在最小值,多出的位移量從另一側補償回來,總寬保持不變。
三是表頭與內容同步。inOneTable 判斷表頭與內容是否在同一個 table(若未使用固定表頭方案則為 true)。若是分離的兩個 table,就必須同時更新 body 首列的對應 td,否則會錯位。
四是 mouseup 綁在 document 上,而非表頭上。這樣滑鼠移出表頭範圍後放開,拖曳狀態也能正確結束,不會卡在 resizing 狀態。
這份程式完成度高,但仍有幾個值得優化的點。minInterVal = 0 表示節流實際上沒啟用,可設為 16 左右(約 60fps 的一幀)以減少不必要的重排。new Date() * 1 這種取時間戳的寫法,現在可以直接用 Date.now() 或 performance.now()。另外每次 mousemove 都呼叫 width() 會觸發 reflow,把寬度快取在 mousedown 時一次讀取會更順。
最後,若要在新專案實作同樣功能,建議直接採用成熟的套件(如 DataTables、ag-Grid、TanStack Table),它們在鍵盤可訪問性、觸控支援、ARIA 屬性等方面都做了完整處理,這些是純手寫方案最難補齊的部分。