教程说明:
这是一个告诉大家如何快速的利用GT-Grid开发列表的基础教程.以后会推出"高级教程".
查看 其他教程,以及最新版本信息,请 点击这里
第八章: 可编辑列表 之 添加记录
这章将主要讲解,如何添加记录
将上一章编写的"mydemo7.html"另存为"mydemo8.html".
=========================================
要添加记录,首先要做的就是在工具栏上增加一个"添加记录"的按钮,只需在 toolbarContent 里加入 "add"即可.
var gridConfig={ /* ... 略去其他属性设置 ...*/ toolbarContent : 'nav | goto | pagesize | reload | add del save | state' , };
这时候,工具栏会多出一个"+"按钮, 点击他就可以增加数据了.
默认情况下,点击添加按钮, 会增加一条空记录. 该记录和数据集里已存在的记录具有相同的结构和字段, 所不同的是所有的字段值都是空字符串''.
在本例中, 我们允许编辑的列是 数学成绩 和 英语成绩. 但是对新增加的记录, 学号 姓名 年龄 也需要是可编辑的
(total由于是由另两个值计算而来,而详细信息为扩展的显示列,所以该两列无需编辑)
如果我们希望某一列只有在新增数据时是可编辑的, 那么只要为该列指定编辑器(editor),同时设置列属性 editable 为 false 即可.
示例如下:
var colsConfig = [ /* ... 略去其他属性设置 ...*/ { id : 'no' , header : "学号" , width : 50 , editable:false , editor: { type :'text' ,validRule : 'R,integer' }}, { id : 'name' , header : "姓名" , width : 100 , editable:false , editor: { type :'text' ,validRule : 'R' }}, { id : 'age' , header : "年龄" , width : 50 , editable:false , editor: { type :'text' ,validRule : 'R,integer' }}, ];
其中前三列, 对于现有数据是无法进行编辑的, 但是新增加的记录是可编辑的.
=========================================
前面讲的内容 告诉了大家如何添加一条空记录, 同时对它进行编辑.
但是很多时候,我们并不希望新增加的数据是空的, 而是有默认值的(就相当于提供一个新记录的模板)
我们可以通过 设置 grid的 defaultRecord属性来实现这个功能.
该属性值 可以为一个 缺省的reocrd对象,该对象和现有的record结构一致.
如下面的代码:
var gridConfig={ /* ... 略去其他属性设置 ...*/ defaultRecord : { no : 111 , name :'(请输入姓名)', age : 11, gender : 'U' , english : 60 , math :60 } }
那么此时新增的记录将不再是空的新记录, 而是有默认值的新记录.
上面的例子详细介绍了 如何使用 新数据的静态模板.
其实有时候我们的模板是动态的.对于这种情况, GT-Grid也是支持的.
defaultRecord 也可以是一个函数, 该函数返回值是一个缺省的reocrd对象,该对象和现有的record结构一致.
例如你希望新加入的一行记录的值 默认等于 列表某一条记录.
defaultRecord : function(grid, dataset ){ /* 伪代码 */ var record= grid.getRecord(0); // 取得grid.中的第一行记录 var rr= clone(record); // 克隆record. (注意 一定要clone) return rr; // 返回 克隆的记录,作为数据模板. }
这时候 defaultRecord属性的指就是一个function了. 参数grid, dataset分别代表当前表格 和当前数据集 )
=========================================
GT-Grid 的编辑 默认支持 "跨页编辑,一次保存".
也就是使用者无需 编辑一页 保存一次, 可以在多页之间编辑 然后一次保存.
不过为了更好的实现这个功能, 建议在 dataset 定义中 通过"uniqueField"属性来指定"唯一索引列/主键/唯一性字段".
虽然这么做不是必须的, 但是强烈建议开发者为每一个dataset都指定uniqueField.
uniqueField就是 告诉GT,数据中 哪一列是具有唯一性的. 例如,在本例中 学号"no" 是数据的主键. 那么就可以像下面这样定义:
var dsConfig= { data : data1 , uniqueField : 'no' , fields :[ {name : 'no' , type: 'int' }, {name : 'name' }, {name : 'age' , type: 'int' }, {name : 'gender' }, {name : 'english', type: 'float' }, {name : 'math' , type: 'float' }, {name : 'total' , type: 'float', initValue : function(record){ return record['english'] + record['math']; } } ] };
如果 数据的 "唯一性字段" 是一个联合主键(由多个字段共同确定唯一性) ,
那么实现也很简单:
1 定义一个扩展数据列 , 类似上面的total.
2 在该扩展列的 initValue 方法里 ,返回 联合主键拼接成的字符串(中间要用有特殊字符链接一下).
例如, 假设, no并不能确定唯一性, 而是需要 no 和 age 共同确定唯一性 , 那么我们可以这么定义:
var dsConfig= { data : data1 , fields :[ {name : 'no' , type: 'int' }, {name : 'name' }, {name : 'age' , type: 'int' }, {name : 'gender' }, {name : 'english', type: 'float' }, {name : 'math' , type: 'float' }, {name : 'total' , type: 'float', initValue : function(record){ return record['english'] + record['math']; } }, {name : 'stdKey' , initValue : function(record){ return record['no'] +'__' + record['age']; } } ], uniqueField : 'stdKey' };
为什么要用"__"这类的特殊字符链接一下?
理由很简单, 确保拼接出来的字符串具有唯一性.
如果不这么做,而是直接相连 , 那么对于"1号19岁的同学 , 11号9岁的同学"这样的数据就难以区分了.
=========================================
加入添加数据功能后, 提交的数据里 insertedRecords 下面就会有删除的记录信息.
然后还是 json串--->java对象的转换. 这里就不再累述.
对于新增的数据, 在点击保存的时候, GT-Grid会对数据再次进行校验, 以防止用户与在点击"+"按钮后, 不去碰那些新增加的数据.
=========================================
到目前为止, "用GT-Grid创建一个支持CRUD的列表"的全部过程我们就讲解完了.
但是这些只是GT-Grid的最基本的功能而已, 下一章开始 将为大家讲解更多深入的内容,包括:
对数据进行排序和过滤 ,对列进行冻结/隐藏/编组, 以及GT-Grid的事件机制, 复杂表头列表....还有更多其他的功能.
同时 还将推出 FAQ & How To ... 系列教程. 专门用来讲解那些 相对细小同时不易分类的知识.
=========================================
P.S.:
感觉这篇没有之前被我误删除的那篇"第八章"写的好 写文档和写文学作品一样 需要灵感, 我的灵感都在丢失的第八章里用尽了 ...
计划中的 "FAQ & How To ..." 内容:
如何实现数据导出?
如何在重新统计总行数?
如何在编辑时将错误输入自动转换成正确的值,而不是提示错误信息?
GT-Grid和ECSide是什么关系?有何异同?
为什么不支持日期类型?日期类型的格式化怎么办?
为什么对中文排序时结果和预期不符?