HTML标准化页面制作规范.doc

WEB 标准化页面制作规范 1 WEB 标准化页面制作规范 编写人：郭福恩 MSN： WEB 标准化页面制作规范 2 目 录 1.前言前言5 1.1.制作规范编写目的及原则5 1.2.制作规范适用的工作人员5 1.3.制作规范制定的范围5 1.4.制作规范适用的产品范围6 2.站点目录结构站点目录结构6 2.1.目录名称的命名6 2.2.站点目录层次结构6 3.HTML 代码编写部分代码编写部分7 3.1.页面文件的大小7 3.2.页面文件内容显示时长8 3.3.代码的编写格式8 3.4.文件名称的命名9 3.5.文件的标准名称9 3.6.DOCTYPE 声名 9 3.7.XMLNS命名空间声明10 3.8.META标签描述10 3.9.TITLE页面标题11 3.10.引入 CSS 样式文件.11 3.11.引入SCRIPT脚本文件.11 3.12.标签要有结束符12 3.13.表格代码定义12 3.14.标签属性值定义13 3.15.标签属性的缩写13 3.16.引入图片的定义14 3.17.页面内容的长度定义14 3.18.NAME属性的定义14 3.19.代码的调试工具15 3.20.代码的测试15 3.21.代码的校验16 4.CSS 代码编写部分代码编写部分.16 4.1.文件的大小定义16 4.2.代码的编写格式16 4.3.文件名称的命名17 4.4.基本文件17 4.5.文件的编码18 4.6.ID和CLASS命名的规范18 4.7.注释的写法18 4.8.代码书写样式19 WEB 标准化页面制作规范 3 4.9.通用样式定义标准20 5.内容制作部分内容制作部分21 5.1.图片大小21 5.2.图片的名称21 5.3.关于 1 像素透明图片21 5.4.图片的应用格式22 5.5.内容宽度的适应22 5.5.1.可拉伸的内容定义22 5.5.2.适当拉伸的内容定义23 5.5.3.不可拉伸的内容定义24 6.意见反馈意见反馈24 WEB 标准化页面制作规范 4 1. 前言前言 W3C 是“World Wide Web Consortium”的缩写，中文名称为“万维网组织” 。 W3C 主要工作是研究和制定开放的规范（事实上的标准） ，以便提高 web 相关产品的互用性。 WEB 标准是由 W3C 和 ECMA 国际（前身为欧洲计算机制造商协会）制定的一系列标准的集 合。 WEB 标准的核心标准的核心：结构结构（Structure） 、表现表现（Presentation）和行为行为（Behavior）相分离： 结构化标准语言主要包括：XHTML 和 XML； 表现标准语言主要包括：CSS2.0； 行为标准主要包括：对象模型（如 W3C DOM） 、ECMAScript 等。 XHTML 是 The Extensible Hypertext Markup Language 可扩展标识语言的缩写，是一种增强 了的 HTML。 CSS 是 Cascading Style Sheet 的缩写，译作层叠样式表单 ，简称样式表 。是用于增强 和控制网页内容样式并允许将样式信息与内容相分离的一种标记性语言。 ECMAScript 是一种由 ECMA 国际（European Computer Manufacturers Association）通过 ECMA-262 标准化的脚本程序设计语言。这种语言在万维网上应用广泛，它往往被称为 JavaScript 或 JScript，但实际上后两者是 ECMA-262 标准的实现和扩展。 1.1. 制作规范编写目的及原则制作规范编写目的及原则 本文档是作为 WEB 页面制作的一个规范性的文件，可以帮助提高页面制作人员的工作质量和 效率。 原则：规范代码的编写、提高代码的质量、提升编写的效率、增加界面的浏览速度。 1.2. 制作规范适用的工作人员制作规范适用的工作人员 本文档主要面向：WEB 页面制作人员、视觉设计人员，WEB 开发人员也可以参阅了解相关内 容，阅读本文档需要掌握相关基础知识： 1.掌握 html4.0 和 Xhtml1.0 相关标准和用法； 2.掌握 css2.0 相关标准和属性； 3.对 JavaScript 脚本的有一定程度的了解。 1.3. 制作规范制定的范围制作规范制定的范围 本文档对站点目录的建立、XHTML 文件编写、CSS 样式编写以及制作中的方法进行了规范化 定义。 行为方面的 JavaScript 规则不在此列。 WEB 标准化页面制作规范 5 对于本文档中一些需要掌握的技术技能和技术知识本文档不做详细描述，请另外阅读相关技术 知识文档。 1.4. 制作规范适用的产品范围制作规范适用的产品范围 本文档适用于基于 HTML 页面的产品。 2. 站点目录结构站点目录结构 2.1. 目录名称的命名目录名称的命名 【规则内容】采用小写小写的英文单词或拼音，长度不超过 20 个字符（10 个汉字） ，名称要能反 映目录的内容，具有语义化效果，易于理解和认知。 【补充说明】 不要不要采用中文字符、下划线、数字和特殊字来符命名目录名称。 目录名称也直接关系到“搜索引擎搜索引擎”的友好度。 【示例内容】图片目录（images） 【应用方法】达到规范定义推荐采用以下的方法： 1.参照此规范文件来建立自己的目录名称。 2.将常用的目录建立为模板，重复使用。 2.2. 站点目录层次结构站点目录层次结构 以文件类型文件类型来划分页面内容，建立相应的目录结构。 【规则内容】 无换肤要求的无换肤要求的目录结构：目录结构： css 文件目录：存放 CSS 样式文件 flash 文件目录：存放.swf 文件 html 文件目录：存放分栏目内容页面 images 文件目录：存放图片文件 javascript 文件目录：存放 JS 文件 language 文件目录： 存放多种语言文件 library 文件目录：存放库文件 templates 文件目录： 存放模板页面 index.html 首页文件 product.html 产品内容文件 WEB 标准化页面制作规范 6 有换肤要求的目录结构：有换肤要求的目录结构： html 文件目录： 存放分栏目内容页面 images 文件目录： 存放非换肤用图片文件 skin 换肤目录： 存放换肤样式和图片 skin1(皮肤 1 目录) img 文件目录 皮肤 1 的图片(自定义) style1.css 皮肤 1 的样式(自定义) skin2(皮肤 2 目录) img 文件目录 皮肤 2 的图片(自定义) style2.css 皮肤 2 的样式(自定义) script 文件目录： 存放 JS 文件 index.html 首页文件 product.html 产品内容文件 【补充说明】 目录的层次深度 首选参数 (preferences) 状态栏(status Bar) 连接速度(connection) 在右下角状态栏会显示计算结果： 【应用方法】达到规范定义推荐采用以下的方法： 1.减小文件大小； 2.优化代码结构，实现分块显示内容； 3.3. 代码的编写格式代码的编写格式 【规则内容】所有 HTML 标签和属性名，在 XHTML 文件中必须采用小写小写格式。 【补充说明】无 【示例内容】 WEB 标准化页面制作规范 8 正确代码格式： 错误代码格式： 【应用方法】达到规范定义推荐采用以下的方法： 1.尽量采用手工编写代码； 2.如果使用工具软件生成或拷贝的代码，要认真检查一下代码格式。 3.4. 文件名称的命名文件名称的命名 【规则内容】采用小写小写的英文单词或拼音、下划线、数字，名称长度 框架页面文件采用此声明 模板页面文件采用此声明 【补充说明】无 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.根据文件类型采用合适的声明； 2.直接利用 Adobe Dreamweaver 工具软件生成 DOCTYPE。 3.7. xmlns 命名空间声明命名空间声明 xhtml 是 html 向 xml 过渡的标识语言，它需要符合 xml 文档规则，因此需要定义命名空间。 【规则内容】 【补充说明】必须添加 xmlns 命名命名空间声明 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.直接利用 Adobe Dreamweaver 工具软件生成。 WEB 标准化页面制作规范 10 3.8. meta 标签描述标签描述 meta 标签用来描述一个 HTML 网页文档的属性，例如字符编码、网页描述、关键词、日 期等信息。meta 标签内容直接关系到对搜索引擎搜索引擎的友好度，所以一定要建立好相关信息。 【规则内容】 【补充说明】前台制作与后台开发的编码格式一定要一致 字符编码：国际化的项目采用编码：UTF-8； 字符编码：简体中文项目采用编码：GB2312； 字符编码：繁体中文项目采用编码：GBK； 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.字符编码：利用 Adobe Dreamweaver 工具软件进行转换。 3.9. title 页面标题页面标题 【规则内容】 页面内容标题 【规则内容】 非框架类型的文件，则要在每个页面中 title 写明与内容对应的标题。 框架类型的文件，附属的文件在其页面中可不用添写 title 内容。 title 内容要简洁、明确，不要超过 20 个字符。 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.添加标题性内容，内容简洁； 3.10. 引入引入 CSS 样式文件样式文件 页面中的样式定义要全部放入 CSS 样式文件中，采用引入至 XHTML 文件中方法来应用。 【规则内容】 【补充说明】特例：综合类型的站点首页，可以考虑将 CSS 样式代码直接嵌入页面代码开始 处，以减少页面请求次数，加快页面显示速率。 【示例内容】无 WEB 标准化页面制作规范 11 【应用方法】达到规范定义推荐采用以下的方法： 1.将所有的样式定义单独存入 CSS 文件中，然后再引用到 HTML 文件中。 3.11. 引入引入 script 脚本文件脚本文件 【规则内容】 【补充说明】 为加快页面显示速度，可以将 JS 代码放在页面代码最末尾处。 要确保脚本文件的兼容性，在不同的浏览器中能正常使用。 禁止添加 language 属性，因其在 XHTML1.0 中不被支持。 使用安全的 JS 脚本文件，采用 WEBX 组发布的效果文件，如果库中没有所 要内容，推荐使用 UE 的 JQ 效果库内容。 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.尽可能的将 JS 脚本放入单独文件中，进行引用； 2.用不同浏览器测试 JS 效果的可用性。 3.12. 标签要有结束符标签要有结束符 【规则内容】成对出现的标签要有结束符号，单个标签则必须要关闭。 【补充说明】无 【示例内容】 成对标签必须有结束标签 代码格式： 错误代码： 单个标签必须关闭 代码格式： 、 错误代码： 、 【应用方法】达到规范定义推荐采用以下的方法： 1.编写代码时一定要添加结束符号“/” 。 3.13. 表格代码定义表格代码定义 【规则内容】请正确使用以下表格元素，表格的嵌套 这是我的表格标题 表头单元格 1 表头单元格 2 Sum $180 January $100 February $80 【应用方法】达到规范定义推荐采用以下的方法： 1.不要用 table 进行布局定义； 2.用 CSS 定义来控制表格的样式； 3.将内容进行分块定义，不要都嵌套在一个表格内。 3.14. 标签属性值定义标签属性值定义 【规则内容】属性值要使用双引号“” 。 【补充说明】无 【示例内容】 代码格式： 错误代码： 【应用方法】达到规范定义推荐采用以下的方法： WEB 标准化页面制作规范 13 1.编写代码时一定要添加结束符号“/” 。 3.15. 标签属性的缩写标签属性的缩写 【规则内容】属性值禁止缩写，要将属性名称和值都写全了。 【补充说明】无 【示例内容】 代码格式： 错误代码： 【应用方法】达到规范定义推荐采用以下的方法： 1.将标签的属性和值写完整。 3.16. 引入图片的定义引入图片的定义 【规则内容】Img 标签中必须添加 alt 属性，文字表述要清晰。 【补充说明】alt 属性说明有利于搜索引擎的检索； 当图片没有显示时，alt 属性会标示出此图片的说明； 装饰类的图片，可以不添加文字说明，值可以为空。 【示例内容】 【应用方法】达到规范定义推荐采用以下的方法： 1.根据图片内容添加 alt 属性内容，以保证图片没有下载完时，可以看到文字说明。 3.17. 页面内容的长度定义页面内容的长度定义 【规则内容】页面内容不要太长，以免影响浏览者对内容的接收质量。 【补充说明】 产品类： 首页的纵向滚屏 【应用方法】达到规范定义推荐采用以下的方法： 1.编写页面代码时将 name 属性置为空； 3.19. 代码的调试工具代码的调试工具 【规则内容】针对 IE 浏览器和 Firefox 浏览器的 HTML 代码调试工具： IE 浏览器，采用 IE Developer Toolbar Firefox 浏览器，采用 Firebug 【补充说明】无 【示例内容】 无 【应用方法】无 3.20. 代码的测试代码的测试 【规则内容】制作完的页面一定要通过 IE6、IE7、IE8 和 Firefox3.0 浏览器的测试。 【补充说明】禁止在 1024*768 分辨率下出现水平横滚动条。 测试的浏览器：(2009.9 月统计) 市场占有率：IE（67%） 、Firefox（23%） WEB 标准化页面制作规范 15 图示：09.7 月（上图）和 8 月（下图）两个月的统计 数据来源：Net Applications 研究机构 测试的分辨率： 市场使用率：1024768（77%） 、1280800（8%，此为宽屏分辨率） 图 示： 2007.11 统计 WEB 标准化页面制作规范 16 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.编写代码时考虑不同浏览器对相同代码解释的差异； 2.非正常显示时，可考虑使用 CSS Hack 写法，参见“附件：CSS Hack 汇总.doc” 。 3.21. 代码的校验代码的校验 【规则内容】制作完的页面一定要校验代码是否符合 W3C 的标准。 【补充说明】代码验证路径：/#validate_by_upload 【示例内容】无 【应用方法】无 4. CSS 代码编写代码编写部分部分 4.1. 文件的大小定义文件的大小定义 【规则内容】样式文件 = 256 的图片采用 JPG 格式 【补充说明】除 GIF 和和 JPG 格式以外，不得采用其它的图片格式 【示例内容】无 【应用方法】达到规范定义推荐采用以下的方法： 1.使用工具软件 adobe photoshop 根据色值来决定存储图片的格式。 5.5. 内容宽度的适应内容宽度的适应 5.5.1.可拉伸的内容定义可拉伸的内容定义 内容在不同宽度的分辨率中显示时，布局要整齐、排版比例要协调。 【规则内容】内容拉伸后不影响内