京华ExOA协同系统(J2EE版)数据表格控件二次开发手册.doc

概述 在现有的业务流程中，经常会遇到同一个表单申请多条记录的情况，由于现有产品表单的局限性，不能动态地添加多条业务记录，因此需要一个可以由用户自行添加记录的控件，方便记录数据。经过多次试验，数据表格控件是一个比较好的解决方案。 图1 数据表格控件设置界面 在数据表格控件中填写脚本函数与表单控件中的脚本函数有几个相同点和不同点 1、相同点： 表格控件中的脚本函数和表单控件中的脚本函数都是javaScript。 2、不同点： 两个表格控件生成的页面不同，表格控件的页面嵌套在表单控件的页面中。 属性配置 在表单设计的时候可以通过“嵌套JSP”控件拉出数据表格控件，并可以设置有什么列，设计列的内容和样式。列的设置包括列标识、列名称、数据类型、控制类型等。 数据类型 类型名称 说明 字符 整型 浮点型 日期 配合日期控件，返回格式”yyyy-MM-dd” 控件类型 控件名称 说明 文本框 下拉选择 需要设置备选内容 日期控件 数据类型必须为日期 文本域 可以输入多条记录 自定义 校验方法 只需要在校验方法中填入校验方法名。自己写校验的方法，方法的参数为value,record,colObj,grid，如：校验输入值是否为百分数。 function checkqz(value,record,colObj,grid){ var content = value; var reg = /^(100||[1-9]?\d?((\.\d)?))%$/; if(reg.test(content)){ return true; }else{ return 请输入正确格式,0-100以内数字+%，只保留一位小数; } } 渲染方法 可以改变列表的格式，用法类似校验方法。 备选内容 当控件类型选择的是下拉框时，下拉框的内容由此确定 格式为控件显示内容1:下拉显示内容1,控件显示内容2:下拉显示内容2。 如：计薪:计薪,调休:调休 脚本开发 内置事件 afterEdit( value, oldValue, record, col, grid) 对单元格进行修改后，光标离开单元格时触发事件 参数名称 类型 参数说明 Value Any 新输入的值 OldValue Any 旧值 Record Object or array 该操作所在行记录集合对象 Col Object 该操作所在列对象 Grid Object 表格控件对象 beforeEdit( value, record, col, grid) 在对单元格修改之前触发事件 参数名称 类型 参数说明 Value Any 新输入的值 Record Object or array 该操作所在行记录集合对象 Col Object 该操作所在列对象 Grid Object 表格控件对象 beforeRowSelect( record, row, rowNo, grid) 在选中一行之前触发事件 参数名称 类型 参数说明 Record Object or array 获取该行记录 row Object 获取该行对象 rowNo Number 获取选择的行号 Grid grid 表格控件对象 beforeDelete(data, row, grid) 在删除一行之前触发事件 参数名称 类型 参数说明 dara Record or Object 数据记录 row Object 行对象 Grid Object 控件对象 afterRowSelect(value, record, cell, row, colNo, columnObj, grid) 在选中一行后触发事件 参数名称 类型 参数说明 value Any 当前值 record Object or array 行记录 cell Object 单元格对象 row Object 行对象 colNo Number 列序号 columnObj Object 列对象 grid Object 表格控件对象 customRowAttribute(record, rowNo, grid) 修改行记录 参数名称 类型 参数说明 record Object or array 行记录 rowNo Number 选中的行数 grid Object 表格控件对象 onComplete( grid) 控件加载完成后触发事件 参数名称 类型 参数说明 grid Object 表格控件对象 onRowClick(value,record,cell,row, colNo, columnObj, grid) 点击行触发事件