DIV CSS 佈局教程網

左側固定表頭的 JavaScript 表格控制項
編輯:JavaScript綜合知識     

專案裡需要一個「左邊那欄是標題」的表格,翻遍現成的函式庫都沒有合適的,於是就自己寫了一個。這個 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 是預留邊框寬度,避免資料區與表頭區加起來超出容器而產生不必要的橫向捲軸。

組裝 DOM

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。這個細節常被忽略,但空表格塌成一條線是很難看的。

對外 API

// 動態更新資料
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 這類成熟方案會更划算。

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