DIV CSS 佈局教程網

實作可拖曳調整欄寬的表格:表頭固定與欄寬拖動
編輯:關於JavaScript     

這個範例實作了兩個常見需求:捲動時表頭固定不動,以及用滑鼠拖曳邊界調整欄寬。整個實作以 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 屬性等方面都做了完整處理,這些是純手寫方案最難補齊的部分。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved