DIV CSS 佈局教程網

jQuery 表格動態新增列並為新列綁定事件:含 timepicker 實戰
編輯:JQuery特效代碼     

編輯型表格的行數往往事先無法確定。若一次給定過多空白列,頁面冗長、加載變慢;若完全不給,使用者每加一筆就得按一次新增。比較好的折衷是「保持底部有若干空白列,使用者一動就自動補上」。以下示範這個做法,並處理最麻煩的部分——新列的插件綁定。

需求拆解

  1. 點擊 insertAfter / insertBefore,在目前列的前後插入新列。
  2. 表格tained 底部維持固定數量的空白列,一旦有列被填寫就自動補足。
  3. 新插入的列裡若有 timepicker 這類需要初始化的插件,必須重新綁定,否則新列上只有一個純文字框。
  4. 提供 Clear(清空值)與 Reset(還原預設值)兩種清除行為。

HTML 結構

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>表格動態新增列</title>
<link href="../Script/jquery-easyui-1.3.2/themes/default/easyui.css" rel="stylesheet" />
<style>
.autoRows { width:350px; border:1px green solid; }
.autoRows tbody tr td { border-bottom:1px green solid; margin:0px; }
.autoRows thead { background-color:#8ec7d7; }
.autoRows tfoot { background-color:#8ec7d7; }
</style>
</head>
<body>

<table border="0" cellspacing="0" id="table1" class="autoRows">
  <thead>
    <tr><th>表頭1</th><th>表頭1</th><th>表頭1</th></tr>
    <tr><th>表頭2</th><th>表頭2</th><th>表頭2</th></tr>
  </thead>
  <tbody>
    <tr>
      <td><input id="Button1" type="button" value="insertAfter"
                 onclick="addrow(this);" /></td>
      <td><input id="Button3" type="button" value="Clear"
                 onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, false);" /></td>
      <td><input id="Text2" type="text" value="aaaa" /></td>
    </tr>
    <tr>
      <td><input id="Button2" type="button" value="insertBefore"
                 onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
      <td><input id="Button4" type="button" value="Reset"
                 onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
      <td><input id="Text1" name="ttt" type="text" value="asdfasfasfdsd" /></td>
    </tr>
    <tr>
      <td><input id="Button5" type="button" value="insertBefore"
                 onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
      <td><input id="Button6" type="button" value="Reset"
                 onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
      <td><input id="Text3" name="Text3" type="text" /></td>
    </tr>
  </tbody>
  <tfoot>
    <tr><th>表尾1</th><th>表尾2</th><th>表尾3</th></tr>
  </tfoot>
</table>

<div style="height:20px;"></div>

<table border="0" cellspacing="0" id="table2" class="autoRows">
  <thead>
    <tr><th>表頭1</th><th>表頭1</th><th>表頭1</th></tr>
    <tr><th>表頭2</th><th>表頭2</th><th>表頭2</th></tr>
  </thead>
  <tbody>
    <tr>
      <td><input id="Button7" type="button" value="insertAfter"
                 onclick="addrow(this);" /></td>
      <td><input id="Button8" type="button" value="Clear"
                 onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, false);" /></td>
      <td><input id="Text4" type="text" value="aaaa" /></td>
    </tr>
    <tr>
      <td><input id="Button9" type="button" value="insertBefore"
                 onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
      <td><input id="Button10" type="button" value="Reset"
                 onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
      <td><input id="Text5" name="ttt" type="text" value="asdfasfasfdsd" /></td>
    </tr>
    <tr>
      <td><input id="Button11" type="button" value="insertBefore"
                 onclick="$.fn.tableAutoRow.insertRow(this, 1, true, false);" /></td>
      <td><input id="Button12" type="button" value="Reset"
                 onclick="$.fn.tableAutoRow.clearRowData(this, 2, 2, true);" /></td>
      <td><input id="Text6" name="Text3" type="text" /></td>
    </tr>
  </tbody>
  <tfoot>
    <tr><th>表尾1</th><th>表尾2</th><th>表尾3</th></tr>
  </tfoot>
</table>

</body>
</html>

JavaScript

掛載與初始化:

<script src="../Script/jquery-1.7.2.min.js"></script>
<script src="../Script/jquery.tableAutoRow.js"></script>
<script src="../Script/jquery.timepicker.js"></script>
<script type="text/javascript">
$(function () {
    $(".autoRows").tableAutoRow(aaa);

    // 這是「為新列綁定插件」的關鍵回呼
    function aaa(row) {
        $(row).find(':text').timepicker();
    }
});

function addrow(obj) {
    $.fn.tableAutoRow.insertRow(obj);
}
</script>

插件主體:

(function ($) {

    $.fn.extend({
        rowfunction: null,

        tableAutoRow: function (newRowFunction) {
            rowfunction = newRowFunction;

            return $(this).each(function () {
                var tb = this;
                if (!(this.tagName.toUpperCase() == "TBODY")) {
                    if (!this.tBodies[0]) { return; }
                    tb = this.tBodies[0];
                }

                // 加入一個隱藏列作為後續複製的模板
                var lastRow = tb.rows[tb.rows.length - 1];
                var row = $(lastRow).clone(true, true);
                $(row).insertAfter($(tb).find("tr:last")).hide();

                // 為現有列加上自動補列事件
                for (var i = 0; i < tb.rows.length; i++) {
                    AddAutoRowsEvent(tb.rows[i]);
                }
            });
        }
    });

    // 自動增加列
    function autoRows(e) {
        var e = e || event;
        var obj = e.target || e.srcElement;

        while (obj.tagName != "TR") { obj = obj.parentNode; }

        var tb = obj.parentNode;
        var index = $(obj).index();
        var n = 5 - (tb.rows.length - index);

        if (n > 0) {
            var lastRow = tb.rows[tb.rows.length - 1];
            for (var j = 0; j < n; j++) {
                var row = $(lastRow).clone(true, true);
                row.insertBefore($(tb).find("tr:last")).show();

                // 若有回呼函式則執行(重新綁定插件)
                if (typeof (rowfunction) == 'function') {
                    rowfunction(row);
                }
            }
        }
    }

    // 為指定列加上事件
    function AddAutoRowsEvent(tr) {
        if (tr instanceof jQuery) { tr = tr[0]; }

        $(tr).bind('click', autoRows);

        var c = tr.cells.length;
        for (var j = 0; j < c; j++) {
            var childs = tr.cells[j].childNodes;
            for (var k = 0; k < childs.length; k++) {
                if (childs[k].type == "text"
                 || childs[k].type == "textarea"
                 || childs[k].type == "button") {
                    $(childs[k]).bind('focus', autoRows);
                }
            }
        }
    }

    // 在指定位置插入 n 列
    $.fn.tableAutoRow.insertRow = function (obj, n, bAutoRows, isInsertAfter) {
        var loop = 0;
        while (obj.tagName != "TR" && loop < 10) {
            obj = obj.parentNode;
            loop++;
        }
        if (obj.tagName != "TR") { return; }

        var tb = obj.parentNode;

        switch (arguments.length) {
            case 3: var isInsertAfter = true;
            case 2: var bAutoRows = true; var isInsertAfter = true;
            case 1: var bAutoRows = true; var isInsertAfter = true; var n = 1;
        }

        for (var i = 0; i < n; i++) {
            var lastRow = tb.rows[tb.rows.length - 1];
            var row = $(lastRow).clone(true, true);

            if (isInsertAfter) { row.insertAfter(obj).show(); }
            else               { row.insertBefore(obj).show(); }

            if (bAutoRows) { AddAutoRowsEvent(row); }
        }
    };

    // 清除指定範圍內的資料
    $.fn.tableAutoRow.clearRowData = function (obj, startColnum, endColumn, isReset) {
        var loop = 0;
        while (obj.tagName != "TR" && loop < 10) {
            obj = obj.parentNode;
            loop++;
        }
        if (obj.tagName != "TR") { return; }

        var cellsCount = obj.cells.length;

        if (startColnum < 0 || !startColnum) { startColnum = 0; }
        if (endColumn > cellsCount - 1 || !endColumn) { endColumn = cellsCount - 1; }
        if (isReset == undefined) { isReset = false; }

        for (var c = startColnum; c <= endColumn; c++) {
            for (var j = 0; j < obj.cells[c].childNodes.length; j++) {
                setObjData(obj.cells[c].childNodes[j], isReset);
            }
        }
    };

    function setObjData(node, isReset) {
        switch (node.type) {
            case "text":
            case "hidden":
            case "textarea":
                node.value = isReset ? node.defaultValue : "";
                break;

            case "select-one":
            case "select-multiple":
                for (var k = node.options.length - 1; k >= 0; k--) {
                    node.options[k].selected = isReset
                        ? node.options[k].defaultSelected
                        : false;
                }
                break;

            case "checkbox":
            case "radio":
                node.checked = isReset ? node.defaultChecked : false;
                break;
        }

        // 遞迴處理巢狀節點
        if (node.childNodes && node.childNodes.length > 0) {
            var l = node.childNodes.length;
            for (var i = 0; i < l; i++) {
                setObjData(node.childNodes[i], isReset);
            }
        }
    }

})(jQuery);

幾個設計上值得學習的地方

用 defaultValue 實作 Reset。這個插件區分了「Clear」與「Reset」:Clear 一律清空,Reset 則還原到 defaultValue、defaultSelected、defaultChecked——也就是 HTML 上原本寫的值。這是原生 DOM 提供的屬性,用起來比自己做一份初始狀態快照優雅得多。

用隱藏列做複製模板。初始化時先複製最後一列並隱藏,之後新增時 clone 它。這確保新列與原列的結構完全一致,包括所有 class、name 與巢狀結構。

層級上溯時加上 loop 上限。while (obj.tagName != "TR" && loop < 10) 這個防護很重要——若傳入的物件不在任何 TR 內,沒有上限的 while 會一路走到 document 之後變成無窮迴圈,把瀏覽器凍結。

三個必須指出的問題

  • clone(true, true) 會複製事件綁定,但不會複製插件產生的 DOM。timepicker 若在 input 旁插入了圖示或容器,那些是插件自己建立的節點,不在 clone 範圍內。這正是需要 rowfunction 回呼重新初始化的原因。任何靠 JS 改造 DOM 的插件(日期選擇器、驗證提示、標籤輸入框)都會遇到同樣問題,重新初始化是唯一可靠的解法。
  • switch 的 case 遞落寫法有 bug。case 3 只設 isInsertAfter 就落穿,但沒設 n 與 bAutoRows,導致傳三個參數時 n 為 undefined、迴圈根本不會執行。正確做法是用預設值:n = n || 1; bAutoRows = bAutoRows !== false;。
  • 動態列的 name 會重複。複製出來的新列帶著與原列相同的 name 屬性,後端收到多個同名欄位時的處理方式取決於框架,容易出錯。實務上應在複製後重新編號:$(row).find("[name]").each(function(){ this.name = this.name.replace(/\[\d+\]/, "[" + idx + "]"); })。

最後,這個插件依賴 .bind() 與全域變數 rowfunction(多個表格實例會互相覆蓋)。若重寫,改用 .on() 並把回呼存進每個元素的 jQuery data 中,會更穩健。

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