基于WAP2.0代码编写规范.docVIP

WAP2.0代码编写规范 技术部文档 深圳市讯天通信技术有限公司 地址：深圳市福田区北环大道7001号开元大厦2306-2308室电话：0755传真：0755邮编：518034 ：修改记录 日期 版本 说明 作者 2004-2-11 1.0 创建 何锦文编写，欧阳衍锋整理 2004-2-12 审核 王文安 目录 1引言 4 1.1目的 4 1.2范围 4 1.3文件的使用者 4 2命名规范 5 2.1目录结构规范 5 2.2文件及目录命名规范 5 2.3图片命名规范 5 2.4 CSS定义及命名规范 6 2.5其他命名规范 6 2.6尺寸规范 6 2.7表格的嵌套 6 3书写规范 6 3.1 XHTML书写规范 6 3.2对于CSS文档相关联的方法 7 4 WAP2.0支持的标签元素 8 4.1 XHTML Mobile Profile 8 4.2 WAP CSS 9 WAP2.0代码编写规范 1引言 1.1目的 作为软件工程的一个步骤，编码是设计的自然结果，因此，软件的质量主要取决于软件设计的质量。但是，编码的规范程度也对软件的可靠性、可读性、可测试性和可维护性产生深远的影响。针对这个情况，以及考虑本公司的具体情况，这篇文档制定了如下的WAP2.0书写规范，以规范程序员编写的WAP2.0文档，最终增强程序的可靠性、可读性、可测试性和可维护性。 1.2范围 本文档明确了编写WAP2.0的命名规范，书写规范，以及可使用的标签元素等。命名规则包括目录结构规范、文件命名规则及元素命名规则等；书写规范概要地给出编写WAP2.0应遵守的书写要求及书写风格；可使用的标签元素给出WAP2.0中所支持的XHTML及CSS标签。 1.3文件的使用者 本文档使用人员为编写WAP2.0文档的程序员  2命名规范目录结构规范目录建立的原则：以最少的层次提供最清晰简便的访问结构。 目录的命名以小写英文字母，下划线组成。 根目录一般只存放.aspx以及其他必须的系统文件 每个主要栏目开设一个相应的独立目录 根目录下的images用于存放各页面都要使用的图片，images目录下目录(参照命名规范)所有CSS文件存放在根目录下style目录 所有flash等多媒体文件存放在根目录下的目录 所有flash等多媒体文件存放在根目录下的目录文件名称统一用小写的英文字母、数字和下划线的组合尽量按单词的英语翻译为名称。例如：anguage_setting(语言设定) 2.3图片命名规范 名称分为头尾两两部分，用下划线隔开。? 头部分表示此图片的大类性质。例如：标志性的图片我们取名为：logo?；在页面上位置不固定并且带有链接的小图片我们取名为button?；在页面上某一个位置连续出现，性质相同的链接栏目的图片我们取名：menu?；不带链接表示标题的图片我们取名：title?。? 尾部分用来表示图片的具体含义，用英文字母表示。例如： 有onmouse效果的图片，两张分别在原有文件名后加_和_命名。 文件名称统一用小写的英文字母、下划线的组合尽量按单词的英语翻译为名称。例如：js的命名原则以功能的英语单词为名。例如：页面标准按800*600分辨率制作页面长度原则上不超过3屏?规范结束标签所有HTML元素及其属性名称都小写。属性的值放在引号里的”selected”。 码编标签正确嵌套?xml version=1.0 encoding=UTF-8?说明此文档符合xml1.0规范，是采用什么编码进行编写的。!DOCTYPE html PUBLIC -//W3C//DTD XHTML Basic 1.0//EN /DTD/xhtml-mobile10.dtd说明该文档是按照/DTD/xhtml-mobile10.dtd规范书写的，并能使用该DTD文件进行有效性验证。 在head/head中要包含以上meta信息，该信息说明文件的类型及使用的编码类型，以确保xhtml文件能被客户端浏览器正确识别。 如果使用命名空间，可在html标签中加入xmlns=属性来指定所使用的命名空间，如：html xmlns=/1999/xhtml，以使用指定的命名空间。 3.2对于CSS文档相关联CSS样式关联，使用特殊的XML处理指令或者链接元素（位于文档报头里），如下面的例子所示：?xml-stylesheet href=example.css media=handheld type=text/css ? 或者head……标签中加入： link href=example.css type=text/css rel=stylesheet/ 但不允许直接将CSS语句直接内嵌在XHTML文件中。 4