易族智汇前端编码规范V2.0.docxVIP

目录1.范围22.术语和定义23.排版规范23.1.规则24.注释规范34.1.规则35.命名规范45.1.规则45.2.建议56.编码规范56.1.规则56.2.建议87.注释规范97.1.规则9Javashop编码规范版本说明提交人V1.1第一版（初稿）王宏俊V1.2第一版（初稿）SylowV2.0整合两个版本的规范，包括：排版、注释、命名Sylow范围本规范规定了使用Java语言编程时排版、注释、命名和编码的规则和建议。术语和定义规则：编程时强制必须遵守的原则。建议：编程时必须加以考虑的原则。格式：对此规范格式的说明。说明：对此规范或建议进行必要的解释。示例：对此规范或建议从正、反两面给出例子。排版规范规则程序代码块（html、javascript）采用缩进风格编写。缩进的数量为1个tab键（4个空格数）。说明：采用tab键可能不适应不同系统与不同开发工具这些元素独立一行：div、ul、li、p等等，除此之外的元素可以和其他元素写在一行示例：独占一行的标签：可以写在一起的标签：Javascript的排版按照《Javashop编码规范》里的排版规范执行注释规范规则应该在主要的元素块（或div内代码超过10行）的前后增加注释，内容为名称及详细作用。示例：Javascript的注释除function外，其他注释按照《Javashop编码规范》里的注释规范执行。命名规范规则文件夹名称可使用常用的文件夹名称。其他名称利用百度翻译。且文件夹与文件夹的内容要对应，比如购物车文件夹却放了会员的html。常用文件夹名称：cart(购物车)、checkout（结算）、detail（商品详细）、goods（多店铺商家商品）、home（商家页面）、member（会员中心）、store（多店铺商家平台）、common（公共页面，例如header.html等）、css（网站样式*.css）、images（图片）、js（javascript、jquery文件）class常用名称。导航nav页头header主导航mainnav页面主体main顶导航topnav内容content子导航subnav页脚footer菜单menu版权copyright子菜单submenu登陆login标志logo侧栏sidebar广告banner搜索search滚动scroll标签页tab小技巧tips合作伙伴partner加入joinus标题title注册regsiter提示信息msg新闻news下载download按钮button状态status服务service投票vote注释note友情链接friendlinkhtml css js的命名采用全小写，用减号（-）分隔英文字母，文件名开头必须是字母开头。某些情况需要对文件增加前后缀或特定的扩展名（比如：.min.js，.min.css），或一串前缀（比如：2fa89s.main.min.css）。这种情况下，建议使用点分隔符来区分这些文件名中带有清晰意义的元数据。示例：错误的命名：正确的命名一般情况下，ID不能用于样式，ID的样式不能被复用，并且每个页面中你只能使用一次ID。而且ID的选择权重很高，一般情况都应该始终考虑使用class，而不是ID，除非你只使用一次。建议CSS选择器中应该尽量避免使用元素名。如果我们只关心class名，而不是代码元素，这样更加容易维护。编码规范规则a标签的href属性不能写#，若确实无需连接，则应该写成href=”javascript:void(0);行内标签禁止嵌套块级元素。示例：以下代码就是错误的：多媒体元素（例如：图片、视频），要确保其有可代替的接入接口。图片文件我们可采用有意义的备选文本（alt），视频和音频文件我们可以加上说明文字或字幕。（图片的alt属性是可不填写内容的，如纯装饰性图片就可以这么做：alt=””）。HTML内使用双引号，而不是单引号，除非极其特殊的情况。属性选择器或者属性值用双引号，Url的值不需要引号。元素内的属性，不能只写属性不写值。示例：应该改为：每个CSS头部都应该有详细标注，来说明这个css文件的作用。比如：/*==== 商品详细 ====*/CSS内的值必须小写。示例：错误：WIDTH:12PX;应该改为：width: 12px;CSS内不应该把所有的css都写在一行，这样对可读性的影响很大，而且也不能起到压缩css的作用（压缩是使用专业的软件压缩，而不是手写在一行）。示例：如下代码可读性就很差：应该改为：省略0值后面的单位，不要在0值后面使用单位，除非有值。示例:padding:0; margin-top:0;等等PC Html文档类型：Wap Html文档类型：建议样式尽量抽离放到css文件中，尽量不要写行内样式。在wap版中，input为t