1 / 5
文档名称:

代码书写规范.docx

格式:docx   大小:24KB   页数:5页
下载后只包含 1 个 DOCX 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

代码书写规范.docx

上传人:cby201601 2022/4/30 文件大小:24 KB

下载得到文件列表

代码书写规范.docx

文档介绍

文档介绍:规范目的:
为提高工作效率,便于后台人员添加功能及前端后期优化维护,输出高质
量的文档,在网站建设中,使结构更加清晰,代码简明有序,有一个更好的前
端架构,有利于SEO优化。
规范基本准则:
符合web 标准,使用具有语义的标签, 代码时,需要尽量避免多余的父节点;
很多时候,需要通过迭代和重构来使HTML 变得更少。
尽量遵循 HTML 标准和语义,但是不应该以浪费实用性作为代价;
任何时候都要用尽量小的复杂度和尽量少的标文来解决问题。
使用 soft tab( 4 个空格)。
每个属性声明末尾都要加分号。
以下几种情况不需要空格:
属性名后
多个规则的分隔符 ’ 前, ’
!important 后‘ ! ’
属性值中 '( 后和‘ ’ 前) ’
行末不要有多余的空格
以下几种情况需要空格:
属性值前
选择器 ’ >’ ,‘ +前后’ ,‘ ~’
‘ {前‘
!important 前‘ ! ’
***@else前后
属性值中的 ’ 后, ’
注释 ’’ 前
以下几种情况需要空行:
文件最后保留一个空行
'后最好跟一个空行,包括scss中嵌套的规则
属性之间需要适当的空行
以下几种情况不需要换行:
‘ {前‘
以下几种情况需要换行:
‘ {后和‘ ’ }前’
每个属性独占一行
多个规则的分隔符 ’ 后, ’
不允许使用 !important 。
注释统一用‘(scss中也不要用‘// ;具体参照右边的写法;
缩进与下一行代码保持一致;
可位于一个代码行的末尾,与代码间隔一个空格。
最外层统一使用双引号;
url 的内容要用引号;
属性选择器中的属性值需要引号。
使用小写字母,以中划线分隔
scss中的变量、函数、混合、placeholder采用驼峰式命名
相关的属性声明按文章最后面的顺序做分组处理,组之间需要有一个空
行。
颜色16 进制用小写字母;
颜色16 进制尽量用简写。
尽量将媒体查询的规则靠近与他们相关的规则,不要将他们一起放到一个
独立的样式文件中,或者丢在文档的最底部,这样做只会让大家以后更容易忘
记他们。
不允许有空的规则;
元素选择器用小写字母;
去掉小数点前面的0;
去掉数字中不必要的小数点和末尾的 0;
属性值 ’ 0后面不要加单位;’
同个属性不同前缀的写法需要在垂直方向保持对齐,具体参照右边的写
法;
无前缀的标准属性应该写在有前缀的属性后面;
不要在同个规则里出现重复的属性,如果重复的属性是连续的则没关系;
不要在一个文件里出现两个相同的规则;
用 border: 0; 代替 border: none;;
选择器不要超过4层(在scss中如果超过4层应该考虑用嵌套的方式来 写);
发布的代码中不要有***@import ;
尽量少用 ’ *选择器。’
使用 soft tab( 4 个空格)。
不要超过120,但如果编辑器开启word wrap 可以不考虑单行长度。
长字符串拼接用加号。
以下几种情况后需加分号:
变量声明
表达式
return
throw
break
continue
do-while
以下几种情况不需要空格:
对象的属性名后
前缀一元运算符后
后缀一元运算符前