EasyUI DataGrid 单元格编辑 注释版

    最近做组织部项目的时候，需要点击Datagrid，然后能够写入数值；研究了半天没明白是什么意思，后来查资料的时候，直接在easyUI 中文网的Demo中找到了相同的代码，但是代码没有注释，依然不是很理解，后来找同伴一块推敲，基本掌握了整个思路，写出注释来给大家分享；

EeayUI中文网Demo及展示效果：http://www.jeasyui.net/demo/332.html

效果图：

HTML代码；

                    <table id="dg" class="easyui-datagrid" style="width: 1000px; height: 280px;"
                        data-options=" iconCls: 'icon-edit',
                                        toolbar: '#tb',
                                        rownumbers:true,
                                        singleSelect: false,
                                        url: 'QuantifyRecord.ashx/ProcessRequest',
                                        method:'get',
                                        pagination:true,
                                        onClickCell: onClickCell">
                        <thead>
                            <%--field中带有editor的是能够编辑的，其他列是不能编辑的--%>
                            <tr>
                                <th data-options="field:'ck',checkbox:true"></th>
                                <th data-options="field:'DepartmentName',width:200">单位名称</th>
                                <th data-options="field:'Name',width:350">指标名称</th>
                                <%--数字，小数点4位，--%>
                                <th data-options="field:'Data',width:150,editor:{type:'numberbox',options:{ precision:4}}">成绩</th>
                                <th data-options="field:'remarks',width:150,editor:'text'">备注</th>
                            </tr>
                        </thead>
                    </table>

Js代码：

 <script type="text/javascript">

        //可编辑的datagrid  --TODO:范晓权 给EasyUI扩展方法；添加editCell方法；
        //方法扩展editCell；
        $.extend($.fn.datagrid.methods, {
            //两个参数
            // jq: 
            // param:对象，包含index 和 鼠标点击的列属性；
            //jq = [table#dg.easyui-datagrid, context: document, selector: "#dg"], param = Object {index: 1, field: "Data"}  选择的是Data列，
            editCell: function (jq, param) {
                //each() 遍历；
                return jq.each(function () {
                    //options:返回属性对象。 这个时候的this代表：jq;
                    var opts = $(this).datagrid('options');                                                                                                       
                    //getColumnFields:返回列的字段，如果 frozen 设置为 true，则冻结列的字段被返回。
                    //concat:用于连接两个或多个数组。该方法不会改变现有的数组，而仅仅会返回被连接数组的一个副本
                    //与HTML的editor属性有关；能够编辑的列和不能编辑的列；
                    //fields的值，和上面HTML对应；
                        //Array[5]
                        //0: "ck"
                        //1: "DepartmentName"
                        //2: "Name"
                        //3: "Data"
                        //4: "remarks"
                    var fields = $(this).datagrid('getColumnFields', true).concat($(this).datagrid('getColumnFields'));
                    //下面for循环，设定列能够编辑。当不能编辑时，editor的值为undefined，能够编辑值为text;
                    for (var i = 0; i < fields.length; i++) {
                        var col = $(this).datagrid('getColumnOption', fields[i]);
                        col.editor1 = col.editor;
                        //循环到的列，不等于鼠标点击的那一列时，设定列的editor的值为null；
                        if (fields[i] != param.field) {
                            col.editor = null;
                        }
                    }
                    //开始对一行进行编辑。param.index 为行号；对选中的一行进行编辑；
                    $(this).datagrid('beginEdit', param.index);
                    //for循环，设置col
                    for (var i = 0; i < fields.length; i++) {
                        //getColumnOption:返回指定列的选项。
                        var col = $(this).datagrid('getColumnOption', fields[i]);
                        //给列的editor属性赋值；text 或者其他；
                        col.editor = col.editor1;
                    }
                });
            }
        });
        //定义一个 行号遍历 赋值为undefined；
        var editIndex = undefined;
        //该函数的返回值为Boolean；
        function endEditing() {
            if (editIndex == undefined) { return true }
            //验证指定的行，有效时返回 true。 -范晓权
            if ($('#dg').datagrid('validateRow', editIndex)) {
                //结束对一行进行编辑。
                $('#dg').datagrid('endEdit', editIndex);
                editIndex = undefined;
                return true;
            } else {
                return false;
            }
        }

        //双击单元格，index是行值，field是列的字段名；
        function onClickCell(index, field) {
          
            //endEditing 的返回值是boolean 值；当返回值为true的时候；
            if (endEditing()) {
                //选中一行，行索引从 0 开始。
                $('#dg').datagrid('selectRow', index)
                    //行值和字段内容  TODO：范晓权
                        .datagrid('editCell', { index: index, field: field });
                //选中的行值赋值给editIndex;
                editIndex = index;
            }
        }

    </script>

总结：

    一种学习的方式叫做站在巨人的肩膀上，首先研究别人的代码，然后改进代码，最后成为自己的代码。实现功能是一种学习，更重要的是能够融汇贯通，而这需要对知识有一个静下心了解和探索的过程；