JSP文件编码规范.docxVIP

城管扁平化项目页面编写规范修订记录日期版本修订目的描述作者2015-07-081.00文档初建赖鹏飞2015-07-151.10文档修改增加赖鹏飞页面书写规范在JSP编写过程中为表现清晰，便于维护，JSP页面书写要求采用分区编写，即将页面代码分为文件头区、数据定义（取值）区、脚本区、展现区、表单提交区。文件头区需要引入的样式，js文件等都放在decorator.jsp页面，内容如下：在开发JSP文件中，文件头部基本固定。Body下面直接是页面中间的内容如：%@pagelanguage=javapageEncoding=UTF-8%%@taglibprefix=curi=/jsp/jstl/core%%@taglibprefix=fmturi=/jsp/jstl/fmt%%String path = request.getContextPath();String basePath = request.getScheme()+://+request.getServerName()+:+request.getServerPort()+path+/;%!DOCTYPEhtmlhtmlheadmetahttp-equiv=Content-Typecontent=text/html; charset=utf-8/title城管扁平化项目/title/head脚本区图 2-3脚本区示意图页面上用到的js都放到页面结束的DIV下面，body的里面进行编写，如图2-3中A所示。用的多的JS公告插件，都加到decorator.jsp头部文件里。因为用到的jQuery，尽量用jQuery的语法经行JS的编写。弹出层普通消息提示，使用kendo.message(“内容”);有确定按钮和取消按钮的弹出层（删除时使用），使用kendo.confirm(确定删除？,{ok:{text:nbspnbsp确定nbspnbsp,callback:function(e){//确定回调函数e.close();e.destroy();}}});有网页的弹出层嵌套：$(#dialog).kendoWindow({width: 660px,height: 600px, title: 新增帐号,position: {top: 20px },content: %=path%/admin/gotoUserAdd.do?organId= + organId+sessionId=+sessionId,iframe :true});关闭kendoWindow方法：$(#dialog).data(kendoWindow).close();判断弹出层是否存在：if (!$(#dialog).data(kendoWindow)){不存在}else{存在}再次调用kendowindow方法：$(#dialog).data(kendoWindow).open();图 2-4弹出层示意图。文档注释文档注释可能出现在页面的任何位置，同时JSP文件的注释方法有很多，这里制定统一的规范管理。对于JSP的注释方法不限，对于Javascript与HTML的注释则必须使用%-- --%的方式来注释，这是出于对源代码的保护考虑。图 2-6文档注释示意图页面整体规范页面风格目前页面风格统一使用kendoUI的样式。在头部decorator.jsp文件中已经引入。页面中禁用style样式，以便以后页面风格的切换和修改。页面内容尽量少用img图片直接引用。为以后统一按钮等风格，换成背景的class引用方式。页面风格示意图文本框，下拉列表等控件样式普通文本框需要在文本中加入k-textbox样式。下拉列表需要调用JS方法创建, $(#searchType).kendoComboBox();多行文本框，也使用k-textbox样式，但需要再加上大小的另一个样式，这里给一个示例：.cg-ri-textbox{width:320px;height:80px !important;overflow-x:hidden;overflow-y:auto;}textarea class=k-textbox cg-ri-textbox/textarea按钮样式普通按钮样式加上k-button样式。确定按钮加上k-primaryk-button样式Disabled灰掉用js实现：$(#disabledButton).kendoButton({enable:false});过渡页面在页面加载空白时期，应该加上“正在加载中…”的过渡提示。参数取用方法使用jsp表达式取值。也可以用struts标签或者webwork标签。系统参数定义到perties静态文件中，需要有专人来维护。分页方法我们统一使用pager.js的方法经行aj