Web组件(EditGrid)使用手册.doc

Web组件(EditGrid)使用手册版本号：1.0作者： 聂文婷日期:2004 年 10月13日山东浪潮齐鲁软件产业股份有限公司Web组件（EditGrid）使用手册 版本号：1.0 文档修订版本日期更改人描述（注明修改的条款或页）1.02004-10-13聂文婷初稿 2005-2-27聂文婷修改2.5 EditGrid实例说明 目 录1.概述42.使用说明42.1数据源说明42.2标签说明42.3提供的函数72.4环境搭建82.5EditGrid实例说明81. 概述网格客户端主要实现展现数据，响应客户的事件，组织数据，可以用于主从表的维护，显示查询结果，适合展现批量数据，支持日期、索引、下拉框等多种显示方式，支持合计功能。网格服务器端使用taglib技术，封装js,负责从服务器端提取数据，生成html到客户端。Grid分为两类：EditGrid和InputGrid。EditGrid主要用于数据的录入，InputGrid支持数据的修改，也可以设置为只读。2. 使用说明2.1 数据源说明在EditGrid中，为了实现客户端与服务器端的数据映射，将明细信息所对应的databean数据集合（比如List）作为主单信息所对应databean的一个属性。2.2 标签说明标签属性说明：属性默认值必需描述dragColfalsefalse网格是否能拖动（暂未实现）typeinputfalseInput表示录入网格，edit表示编辑网格namegriddivtrue网格的名称propertycollectiontrue网格的属性，明细信息集合在主单信息中的属性名称wholeCssdivAllcssfalse网格样式sumRowtruefalse是否需要合计区headCssdivToucssfalse网格头样式lightOnCssfalse网格点击后的css（暂未实现）detailCsstabTiSkinfalse网格体样式sumCssdivSumcssfalse网格合计区的csscomplexHeadfalsefalse是否复杂网格头(复杂网格头暂未实现)width500false网格宽度height500false网格高度headHeight22false网格头高度detailHeight400false网格体高度sumHeight20false网格合计区高度标签属性说明：属性默认值必需描述indextrue通过定义的index值确定在不同元素之间获得焦点的顺序(暂未实现)nametrue列的名称，与明细信息DataBean的属性对应，名称要符合Java规范propertyfalse如果grid标签的type为edit,则根据此值从DataBean中取值，名称要符合Java规范readonlyfalsefalse是否只读disabledfalsefalse是否使能stylefalse控制列的外观styleClassfalse控制列对应的csstabindexfalse通过定义的tabindex值确定在不同元素之间获得焦点的顺序xmlfalse自定义的一个属性，用于组织成xml串captiontrue表头标题sumLabel空false合计区labelsumScriptfalse合计区的script属性，调用grid.CountSum()合计区的赋值函数onblurfalse当元素失去焦点时发生的事件onchangefalse当元素状态被改变时发生的事件onclickfalse单击时触发的事件ondbclickfalse双击时触发的事件onfocusfalse当元素获得焦点时发生的事件onkeydownfalse按键按下时触发的事件onkeypressfalse按键点击时触发的事件onkeyupfalse按键释放时触发的事件onmousedownfalse按下鼠标按钮时触发的事件onmousemovefalse鼠标移动时出发的事件onmouseoutfalse鼠标移开时触发的事件onmouseoverfalse鼠标移到上面触发的事件onmouseupfalse释放鼠标按钮时触发的事件onselectfalse当元素被选中时发生的事件width100false列宽度标签继承标签,两者属性完全相同；标签继承标签,两者属性完全相同，其宽度设置为零；标签既包含文本框，也包含图标；继承标签，同时也继承标签的属性，其额外属性：属性默认值必需描述imageUrlfalse图标的Url地址imageClickfalse单击图标的响应事件imageDbclickfalse双击图标的响应事件defaultValuefalse默认值标签继承标签,两者属性完全相同；标签继承标签,两者属性完全相同；标签继承标签,同时也继承标签的属性，其额外属性：属性默认值必需描述defaultValuefalse默认值标签,在grid中生成一个下拉框.其选项可以自定义,也可以通过一个集合生成.继承标签,同时也继承标签的属性，其额外属性：属性默认值必需描述valuefalse默认选中选项的valuesize1false高度,同普通下拉框标签属性属性默认值必需描述nametrue选项value对应的集合labelNametrue选项text对应的集合例如: 1111111122222222标签继承标签,同时也继承标签的属性，其额外属性：属性默认值必需描述valuefalse默认日期值hastime0false是否带时间maxYear2100false年份的上限minYear1900false年份的下限imgPathTime.giffalse图片名sourceFormatyyyy-MM-ddfalse默认值日期格式targetFormatyyyy-MM-ddfalse新输入日期格式标签继承标签,同时也继承标签的属性，其额外属性：属性默认值必需描述labelkey false在collection不为null时可以根据ognl取值labelProperty false在collection为null时不可以根据ognl取值collection false如果collection不为null，则从上下文中取到数据集合,根据property取到下拉框中value值, labelProperty取到label值。如果collection为null,则根据beanName和property获取value值数据集合；如果labelName和labelProperty均为null,则label值数据集合跟value值数据集合相同，否则根据labelName或labelProperty获取label数据集合。2.3 提供的函数 init(odivid,Index,primaryKey,Delete,clickEvent,dblclickEvent) 初始化,参数列表为外面DIV的ID,序号列，主键列，隐藏列，单元格的单击事件，双击事件 focus(row,col)焦点到第row行，第col列 getCellValue(row,col)取得第row行，第col列值 setCellValue(row,col)设置第row行，第col列值 index(col) 重新排列序列号 setSumFieldValue(row,col,value) 设置合计区域单元格的值 getSumFieldValue(row,col) 获得合计区域单元格的值 getGridValue(col,tag1,tag2) 获得网格字符串 getGridXmlValue(col)获得网格xml字符串 addRow()添加行 delRow()删除行 CountSum()计算合计区 returnRowCount()返回现在的总行数 getCurrentLine()得到当前行索引 checkHaveRepeat(col)检验第col列是否有重复值 checkHaveEmpty(col)检验第col列是否有空值 addHr()为页面添加一条竖线，调整列用 hidDelCol()隐藏标识为deleteCol的一列 changeDelValue()把一行中deleteCol列得文本框得值变为1 addLine()为表体增加一行 addHeight()为表体增加高度 lightLine(otr)加亮显示一行，参数为要加亮的行 delightLine(otr)还原加亮的行，参数为要恢复的行 IsLast(obj)内部方法，判断当前控件是否是最后行的最后一个 IsLastInRow(obj)内部方法，判断当前控件是否是当前行的最后一个 sum(col)返回某列的合计值 delRowByIndex(index)根据行号index删除指定的行 changeCheckboxValue()改变checkbox的值2.4 环境搭建1.在应用程序的类路径中添加loushang-wb-(版本号).jar, commons-beanutils.jar, commons-collections.jar与commons-logging.jar。比如$WebSphereAppServerinstalledAppsrjtaniewtpetstore.earpetstore.warWEB-INFlib目录。2.添加js文件grid.js。比如$WebSphereAppServerinstalledAppsstandard.eartobacco.warzhntskinsdefaultjs目录。3.添加标签库web-grid.tld。比如$WebSphereAppServerinstalledAppsstandard1.eartobacco.warzhnttlds目录。2.5 EditGrid实例说明后台ViewBean.java类：主表：实现IaddEditGrid类中的setAddGridDetail方法 private String type; private String status;/定义存放从表数据的集合private List orderLines; /为订单增加明细 public void setAddGridDetail(String rows) try int count = Integer.parseInt(rows0); for (int i = 0; i count; i+) addOrderLine(new OrderLineDataBean(); catch (Exception e) throw new IllegalArgumentExce