Web开发规范文档.pdf

Web项 目开 规范文档 序 ✍Standards for developing flexible, durable, and sustainable HTML and CSS, and maintainable JavaScript （开 灵活的、持久的和可持续的HTML和 CSS,和可维护的JavaScript的标准 ！） ———Code Guide by @AlloyTeam ✍ 任何程序员都有 自己的开 习惯 　　后来想想任何人 （甚至小动物 ）都有 自己的做某件事情的习惯 ，而对于开 而言 ，所谓的标准规范 ， 其实就是程序员对 自身的要求 ，和对团队的融入 ，效率 ，质量是每个团队的追求。 　　简述 ：要 自己写的代码 ，别人容易看懂 ！ 　　如果使用其他系统或其他人早已定义好的变量、类、函 数名时 ，需遵循它们原本的形式 ，避免出现问题。 ✍ 摘 自 （阮一峰 ） 所谓编程风格 （programming style ），指的是编写代码的样式规则。不同的程序员 ，往往有不同的编 程风格。 有人说 ，编译器的规范叫做 语法规则 （grammar ），这是程序员必须遵守的 ；而编译器忽略的部分 ，就 叫编程风格 （programming style ），这是程序员可以自由选择的。这种说法不完全正确 ，程序员固然 可以自由选择编程风格 ，但是好的编程风格有助于写出质量更高、错误更少、更易于维护的程序。 所以 ，有一点应该明确 ，编程风格 的选择不应该基于个人爱好、熟悉程度、打字工作量等因素 ，而要考 虑如何尽量使代码清晰易读、减少出错 。你选择的 ，不是你喜欢的风格 ，而是一种能够清晰表达你的意图 的风格。 ✍ 规范 目的 为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档。本 规范文档一经确认, 前端开 人员必须按本文档规范进行前台页面开 。本文档如有不对或者不合适的地方 请及时提出, 经讨论决定后方可更改。 1、程序员可以了解任何代码 ，弄清程序的状况 ； 2、新人可以很快的适应环境 ； 3、防止新接触PHP的人出于节省时间的需要 ，自创一套风格并养成终生的习惯 ； 4、防止新接触PHP的人一次次的犯同样的错误 ； 5、在一致的环境下 ，人们可以减少犯错的机会 ； 6、程序员们有了一致的敌人 ； ✍ 基本准则 @ Chandler BC 本文档使用 看云 构建 - 1 - Web项 目开 规范文档 保证开 的有效性和合理性 ，并可最大程度的提高程序代码的可读性和可重复利用性。 符合web标准, 语义化html, 结构表现行为分离, 兼容性优良. 页面性能方面, 代码要求简洁明了有序, 尽 可能的减小服务器负载, 保证最快的解析速度。 @ Chandler BC 本文档使用 看云 构建 - 2 - Web项 目开 规范文档 开 注意点 要求以UTF-8无BOM信息头格式保存html文件、css文件、j s文件、php文件。(否则可能导致很多意想不到 如果使用!important使一个属性生效 ，那么可以确定 生了层叠优先级问题。 因为xhtml区分大小写 ，可以总是选择使用小写值 ，以避免出现意外错误。 如果不确定一个样式表是否被加载 ，那么可以在样式表中添加一条特殊规则 ，然后再检查它是否可以 成功应用。这条规则通常要设置非常显眼的效果 ，如*{border:1px solid black;}。 PHP中:在定义字符串变量时,应尽量使用单引号.单/双引号包含的HTML标签,输出结果一样.两者的不同 之处在于,双引号中所包含的变量会 自动被替换成实际数值,而在单引号中包含的变量则按普通字符串输 出。 JavaScript中使用,因为W3C规定HTML属性使用,避免两者混淆,CSS文件使用; 反引号(后引号)(`):位于大多数键盘左上角的波浪号之下;slash:斜线[杠] (/); 单引号 （ ）、双引号 （ ）、反斜线 （\ ）与 NUL （NULL 字符 ）; 同时要注意的是一个