版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
1、PageJSP网站编写规范说明目 录1页面书写规范21.1文件头区21.2脚本区21.3表单提交32页面整体规范32.1页面风格32.2特殊控制33页面数据输入与输出43.1必输项的标识与控制43.2输入数据项的控制43.3输出数据的格式化43.4输出数据的预处理44错误页面55过渡页面56局部刷新57弹出窗口58参数命名规范6© Copyright BJSD. 2007 JSP规范1 页面书写规范在JSP编写过程中为表现清晰,便于维护,JSP页面书写要求采用分区编写,即将页面代码分为文件头区、数据定义(取值)区、脚本区、展现区、表单提交区。1.1 文件头区在JSP文件中,有关文档声
2、明的内容均须放在文件头部,即文件头区。对于使用include标签的部分中,file属性的值必须是绝对路径杜绝相对路径。如:<% page languate=”java” contentType=”text/html”;charset=” UTF-8” %><% page import=”java.util.Vector” %><% include file=”/include/head.jsp” %><%><html>1.2 脚本区图 2-3脚本区示意图在数据定义部分结束后,紧接着是该页面将要引用的公共的CSS库文件与JavaScri
3、pt脚本的定义,如图2-3中A所示。自定义的JavaScript脚本须写在公共脚本引用声明之后,如图2-3中B所示。脚本的定义必须在HTML的Head标签书写。1.3 表单提交对于有表单提交、页面通过Form方式跳转,则该Form必须在文档的最尾端(除非同一个页面又多个Form),坚决杜绝将提交Form或者跳转Form与用于显示的Form混杂在一起,或者将该Form至于页面其他位置。图 2-5提交区示意图2 页面整体规范2.1 页面风格首先需要确定页面风格,设定初步CSS样式表文件,(另见CSS文档说明文件!)在页面中的HTML控件的样式,包括使用Tag中的样式均必须采用class="
4、;cssName"的方式来定义,严格禁止在页面中使用bgColor、color等属性定义风格。如下图所示,绿色为正确写法,红色为错误写法。图 2-1 页面风格示意图2.2 特殊控制项目应用中有些由于业务需求的限制要求页面有特殊的控制,例如禁止用户使用鼠标右键功能等,这些限制多数都可以用Javascript脚本来实现。l 屏蔽鼠标右键Javascript可以获取鼠标事件,通过判断可知是否为右键,当是右键时让其不做任何处理。这部分代码应当在Javascript脚本库中体现,并且应当在整个应用框架的主Frame中去引用。l 页面关闭清除Session当关闭浏览器时,浏览器会触发HTML的o
5、nUnload()事件,所以在onUnload()事件中去发出清Session的请求。以往的做法是采用window.open()的方式去发出HTTP请求去触发签退的事件,这种方式如果签退成功的话会自动关闭成功页面,但如果失败的话这个页面将永远也关闭不了。利用XMLHTTP请求的异步方式去发送这个请求将不会产生任何页面的跳转,无论交易成功还是失败均不会给客户带来影响。所以在处理例如页面关闭清除Session这类的交易时,应使用XMLHTTP技术实现,XMLHTTP请求应当在Javascript脚本库中实现,onUnload()事件应在主框架中实现。详细XMLHTTP技术可参阅相关文档。3 页面数
6、据输入与输出3.1 必输项的标识与控制作为必输项的数据域,在其前面标签后必须显示的使用“*”来标示,如下图所示。既然是必输项,必须有相应的脚本对其进行控制即使用JavaScript中判断输入框是否为空即可。图 2-2 必输项标示示意图3.2 输入数据项的控制任何输入项都会有一个输入长度的限制,例如上图中的备注信息,金额的信息也根据业务需求或多或少的有限制,为了防止由于用户的输入超过限制导致异常,则可使用相应的HTML属性进行控制。同时输入数据有要求格式的,例如:E-mail地址、金额、注册名称均需在Javascript脚本库中统一使用正则表达式制定。另外有些数据例如备注信息中如果出现类似“”、
7、“”等特殊字符会影响页面的展示,在录入的过程中控制或者在提交时对输入数据中的特殊字符进行过滤是非常重要的。3.3 输出数据的格式化最常见的需要格式化的是跟日期等有关的数据,一般业务要求用以显示的数据必须为年-月-日即“-”分隔符。应当统一使用UTB的相应Format方法来实现。3.4 输出数据的预处理输出数据如果为Null则必须使用UTB的nvl方法进行预处理,即将null值转换为“”空的字符串。4 错误页面系统有统一的出错页面(/error.jsp)。5 过渡页面在页面操作过程中,无论是点击菜单、提交表单均会有页面跳转的情况发生。传统的做法是直接在点击菜单的URL中指定Operation名称
8、,并传递交易需要的数据,此种方式会产生白页显示在页面上。过渡页面(例如:在点击菜单需要与后台交互后才能生成显示页面的交易),我们通常采用一个过渡页面的方式进行提交交易,然后跳转到需要显示的页面。6 局部刷新这里所说的局部刷新并不是简单的Form的target属性。某些特殊业务需求要求在页面中的某些显示要素按照用户的请求进行更新,而整个的交易页面不受影响,这种需求的实现可以通过两种方式来实现。l 隐藏的IFrame,当用户触发更新数据事件时,将请求Form的target设置为一个隐藏的IFrame中,在IFrame的窗口得到返回内容后,使用opener属性去更新显示页面中的要素;l 同步的XML
9、Http请求,XMLHttp请求是通过ActiveX控件发送请求。第一种利用IFrame应当是比较传统的方式,针对不支持ActiveX技术的页面可以保证实现页面的局部刷新。目前大多数浏览器包括IE、NetScape均已支持ActiveX技术,所以利用XMLHttp方式发送请求是理想的选择。7 弹出窗口项目业务越来越复杂,而针对平台系统的设计又要求用户的操作越来越简单,在同一个业务中须尽量少的发生页面跳转情况。在复杂业务的数据采集过程中,应采用弹出窗口的方式完成。弹出窗口方式通常有两种,一种为标准JavaScript的window.open()方法,使用这种方法通常为页面进入时弹出一个非模态的窗口,但这种方法经常会被浏览器或一些浏览器插件关闭。另外一种模态窗口的方法为居上的,现有的浏览器均没有对其限制,对于数据采集过程应当使用该方式实现。打开模态窗口的脚本应当在JavaScript脚本库中实现。模态窗口可以根据属性的定义去控制工具栏、菜单、状态栏显示与否,但却不能隐藏浏览器栏上方的蓝色(XP蓝色、Win2k为灰色)色带,针对一些特殊的需求要求不显示上侧的蓝色色带,可以使用DIV的方式模拟弹出窗口,需要用到DIV的CSS的层属性即z-index,因需要该DIV居于窗口最上方,所以设置
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 2025年企业外汇代收业务操作规范合同范本5篇
- 二零二五年度企业解除与因合同签订错误员工劳动合同证明3篇
- 2025年度智能家居系统安装与室内装修施工协议2篇
- 2024年塔丝绒项目可行性研究报告
- 2024年双色弯条绒项目可行性研究报告
- 2024年中国幻彩珠光油漆市场调查研究报告
- 2024年中国安石胶市场调查研究报告
- 2024至2030年电梯空调项目投资价值分析报告
- 2024至2030年匹冷凝器项目投资价值分析报告
- 2024年三孔铜接线柱项目可行性研究报告
- 《科学与工程伦理》课件-1港珠澳大桥工程建设中的白海豚保护相关案例分析
- 浙江省杭州市钱塘区2023-2024学年四年级上学期数学期末试卷
- 《湖北省市政基础设施工程质量标准化图册》(燃气管网工程)
- 天车租赁合同范例
- 无机化学实验试题
- 第二单元《第8课循环结构-for循环》教学实录 -2023-2024学年浙教版(2020)初中信息技术八年级上册
- 2025年中考道德与法治二轮复习:主观题 答题模板与技巧(含练习题及答案)
- 衡重式及重力式挡土墙自动计算表
- 有关大学生寒假生活计划-大学生的寒假计划
- 2024年01月11129土木工程力学(本)期末试题答案
- 家政公司员工合同范例
评论
0/150
提交评论