一份代码编写标准
作者: 来源: 添加时间:2006-5-21 23:22:59七、Cookies
7.1 Cookies的作用域
Cookies的Path属性规定了Cookies返回服务器的具体路径。为了使Cookies能够在整个网站的各个目录都可以起作用,应将Domain域属性设为:"/",
Cookies的Domain域属性限制了cookies可由浏览器送达之处。为了使cookies能够在整个网站的各子站点都可以起作用,应将Domain域属性设为:".yourDomain.com"。该值将作为常量cookie_Domain放入站点的公共文件中。即:
Response.Cookies("UserName").Path="/"
Response.Cookies("UserName").Domain= cookie_Domain
7.2 Cookies的有效期
Cookies的Expires属性规定了Cookies的结束作用时间。如果要建立一个会话期间的cookies,即要在客户结束浏览后失效,则一定不能设置该属性。
7.3 Cookies的安全
Cookies内部的敏感信息必须加密,该加密方式在公共密钥函数库中定义。
1.5 URL
包含头文件,页面的链接,提交的页面,用到的图片,如果引用的是如“include”、“image”等公共部分,必须使用绝对路径,即以虚根目录“/”开始的路径,以提高运行效率。例如:
<A HREF="/index.asp">
<IMG src="/edu/files/pic/2006-5/21/0652123225861988.gif"”>
在一个相对独立的模块内部,可以使用相对路径,以提高可移植性。但是,禁止使用“..”返回上一级目录,即禁止使用类似“../images/logo.gif”的URL。相对路径如下书写:
<A HREF="index.asp">
<IMG src="/edu/files/pic/2006-5/21/0652123225995233.gif"”>
确保在指向目录的 URL 中使用后斜杠 (/)。如果您省略了后斜杠,浏览器就会向服务器发出请求,只是为了告诉服务器,它在请求目录。浏览器就会发出第二个请求,将斜杠附加到 URL 后面,只有此后,服务器才能以该目录的默认文档或目录列表(如果没有默认文档且启用了目录浏览的话)响应。附加斜杠可省去第一个、无用的住返。为便于用户阅读,可以省略显示名称中的后斜杠。
例如,写:
<A HREF=http://msdn.microsoft.com/workshop/” TITLE=”MSDN WebWorkshop”>http://msdn.microsoft.com/workshop </A>
这也适用于指向 Web 站点上主页的 URL:使用下面的:<A HREF=http://msdn.microsoft.com/”>,而不使用 <A HREF=http://msdn.microsoft.com”/>。
1.6 日期
在使用、判断和显示日期时,一定要确定年为4位。统一定义为
长日期格式为: XXXX年XX月XX日
短日期格式为:XXXX-XX-XX
在ASP输出时必须使用FormatDateTime()函数进行格式化,前端输入时统一使用XXXX-XX-XX格式,并在后端使用isDate()进行检验。
二、HTML
2.1 标记
HTML 对大小写不敏感,但为改善可读性,规定大写所有标志、属性,小写属性值,属性值外必须加引号,如:<TABLE BORDER=”0” CELLSPACING=”0” CELLPADDING=”0” ALIGN=”left”>
2.2 META 标记
所有中文页面,必须在“<HEAD> … </HEAD>”头中加入如下META标记:
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=GB2312">
该META标记描述本页使用的语言。浏览器根据此项,就可以选择正确的语言编码,而不需要读者自己在浏览器里选择。GB2312是指简体中文,ISO-8859-1是指英文,而台湾BIG5内码的主页则是用BIG5。
在首页和各频道首页应加入如下META标记:
<META NAME="keywords" CONTENT="yourkeyword">
<META NAME="description" CONTENT="your homepage's description">
该META标记声明本页的关键字和描述。在页面里加上这些定义后,一些搜索引擎就能够让读者根据这些关键字查找到你的主页,了解你的主页内容。
在每次都需要重新生成的,不需要用户缓存的页面,应加入如下META标记:
<META HTTP-EQUIV="Pragma" CONTENT="no-cache">
该META标记强制性调用网上的最新版本。浏览器为了节约时间,在本地硬盘上保存一个网上文件的临时版本。在你要重新调用时,直接显示硬盘上的文件,而不是网上的。如果你想让用户每次都看到最新的版本,就加上这句话。
2.3 统一样式表引用
为了使整个网站的风格样式统一,必须统一使用公共的层叠样式列表,即在每个HTML文件的“<HEAD> … </HEAD>”头中加入:
<LINK REL="stylesheet" TYPE="text/css" HREF="/style/default.css">
如果项目相对比较独立,应该使用自己的CSS定义,增加可移植性。
2.4 TITLE设定
所有中文页面TITLE设置需遵照如下标准:
YourDomain.com+空格+本页内容描述
所有英文页面TITLE设置需遵照如下标准:
YourDomain.com+空格+ -+空格+本页内容描述
2.5 表单
2.5.1 文本框:文本框(<INPUT TYPE=”text” NAME=”” …>)的宽度(SIZE属性)以数据库中相对应的字段长度为参考,并参照邻近文本框的宽度,以美观为原则确定;文本框的最大内容长度(MAXLENGTH属性)以数据库中相对应的字段长度为标准确定。
2.5.2 表单提交:必须使用POST方法,而不允许使用GET方法。
2.6 表格
2.6.1 高度和宽度的定义:应直接在单元格属性内用象素数定义,尽量不要用百分比定义,也不要用空白图去撑这个单元格。如特殊情况要求,只宜用百分比对单元格指定宽度,因为Netscape不支持百分比定义的高度。
2.6.2 空单元格:所有需要指定背底色或边框色的空单元格请一定要在该单元格内插入 ,如果该单元格的高度<9或宽度<5时,请用img目录下的none.gif。无背底色和边框色的空单元格,仅仅是用来定位时,请这样写:<TD HEIGHT="??" WIDTH="???"></TD>
2.7 图片
<IMG>标签必须使用WIDTH和HEIGHT属性来定义图片的尺寸,以加快浏览器显示页面的速度。对于一般的非占位用的图片,必须使用ALT属性来定义其文本显示。
2.8 注释
使用注释声明每一子块区的开始和结束,注释语句使用英文。如:
<!— User Login In Zone -->
… …