Web常见约定规范(精选)

时间:2023-11-25 08:36:02

    常见的约定规范

(一)HTML约定规范

  1,html属性顺序:id class name data-xxx (src for type href)(title alt)(aria-xxx role)

  2,a 不允许嵌套 div 和 a

  3,a 里不不可以嵌套交互式元素:a button select等

  4,p里不可以嵌套块级元素 div p h1~h6 ul ol li dl dt dd form等

  5,语义化:blockquote 大段引用; cite 一般引用; code 代码标识; abbr缩写

  6,使用 link 代替 @import

(二)CSS约定规范

  1,class与id属性多个单词组成时单词之间用 - 分隔

  2,属性定义统一使用双引号

  3,布尔类型(disabled checked selected) 等属性不用设置值

  4,组件块和子组件块以及声明块之间使用一空行分隔,子组件块之间三空行分隔

  5,如果使用了多个css文件,按照组件形式分拆

  6,不要将元素选择器和ID class混合使用,不利于维护

  7,样式书写顺序:定位属性放在首位,盒模型放在第二位,其他放在后面

  8,链接的样式顺序:a:link a:visited a:hover a:active

  9,使用translate取代absolute定位会得到更好的fps,动画会更顺滑

(三)JS约定规范

  1,单行注释,独占一行,//后面跟一个空格,缩进与下一行被注释的代码一致

  2,避免使用多行注释

  3,函数说明/方法注释:参数、返回值注释必须包含类型信息和说明

  4,当函数为内部函数,外部不可访问时,可以使用@inner标识

  5,文件注释:内容、依赖关系、兼容性信息

  6,变量、函数、函数的参数、类的方法和属性使用驼峰命名法

  7,类、枚举变量使用Pascal命名法

  8,常量、枚举的属性使用全部大写字母、单词间下划线分隔的命名方式

  9,不要在Array上使用for-in循环,因为遍历的是所有出现在对象及其原型链的键值

  10,尽量使用requertAnimationFrame代替setTimeout,setInterval

  11,声明块的左{前添加一个空格,右}单独成行,:后应添加一个空格,以;结尾

  12,以 , 分隔的属性值,每个逗号后应添加一个空格

以上就是我给大家推荐的一些常见的约定规范!