CSS的编写规范

一、前言

　　

　　如上图，页面在渲染和画图时，耗时还是比较多的，这就对我们的编写要求愈加严格。

　　我们有很多方法来减少上图所示的页面加载耗时的，比如

　　但是更多的还是在于平时的编写规范，我们需要了解浏览器，让他更加便捷快速的理解（加载）我们的代码。

　　另外，在编写页面时，如果内容较多，相应的css也会变得更多、更加复杂。

　　或许会你会想着拆分css成2个或更多的文件，然而这并不是好的方法，会增加向服务器请求的次数，进而延长了页面加载完成的时间。

　　基于以上两点考虑，规范化的编写代码，不仅仅能够减少页面加载的耗时，提升用户体验，还可以使得代码更易于理解，增加可读性。

二、正文

2.1 属性书写顺序

[建议] 同一 rule set 下的属性在书写时，应按功能进行分组，并以 Formatting Model（布局方式、位置） > Box Model（尺寸） > Typographic（文本相关） > Visual（视觉效果） 的顺序书写，以提高代码的可读性。

解释：

• Formatting Model 相关属性包括：position / top / right / bottom / left / float / display / overflow 等
• Box Model 相关属性包括：border / margin / padding / width / height 等
• Typographic 相关属性包括：font / line-height / text-align / word-wrap 等
• Visual 相关属性包括：background / color / transition / list-style 等

另外，如果包含 content 属性，应放在最前面。

示例：相关的属性声明按照给定的顺序做分组处理，组之间需要有一个空行。

.sidebar {
    /* formatting model: positioning schemes / offsets / z-indexes / display / ...  */
    position: absolute;
    top: 50px;
    left:;
    overflow-x: hidden;

    /* box model: sizes / margins / paddings / borders / ...  */
    width: 200px;
    padding: 5px;
    border: 1px solid #ddd;

    /* typographic: font / aligns / text styles / ... */
    font-size: 14px;
    line-height: 20px;

    /* visual: colors / shadows / gradients / ... */
    background: #f5f5f5;
    color: #333;
    -webkit-transition: color 1s;
       -moz-transition: color 1s;
            transition: color 1s;
}

2.2 命名规范

• 类名使用小写字母，以中划线分隔
• id采用驼峰式命名
• scss中的变量、函数、混合、placeholder采用驼峰式命名

/* class */
.element-content {
    ...
}

/* id */
#myDialog {
    ...
}

/* 变量 */
$colorBlack: #000;

/* 函数 */
@function pxToRem($px) {
    ...
}

/* 混合 */
@mixin centerBlock {
    ...
}

/* placeholder */
%myDialog {
    ...
}

2.3 属性简写

属性简写需要你非常清楚属性值的正确顺序，而且在大多数情况下并不需要设置属性简写中包含的所有值，所以建议尽量分开声明会更加清晰；

margin 和 padding 相反，需要使用简写；

常见的属性简写包括：

• font
• background
• transition
• animation

/* not good == 不需要设置属性简写中包含的所有值时，建议不要简写*/
.element {
    transition: opacity 1s linear 2s;
}
/* good */
.element {
    transition-delay: 2s;
    transition-timing-function: linear;
    transition-duration: 1s;
    transition-property: opacity;
}

/* not good == 对于margin、padding需要使用简写*/
.element {
    padding-top: 2rem;
    padding-right:;
    padding-bottom: 2rem;
    padding-left:;
}
/* good */
.element {
    padding: 2rem 0;
}

2.4 媒体查询

尽量将媒体查询的规则靠近与他们相关的规则，不要将他们一起放到一个独立的样式文件中，或者丢在文档的最底部，这样做只会让大家以后更容易忘记他们。

.element {
    ...
}

.element-avatar{
    ...
}

@media (min-width: 480px) {
    .element {
        ...
    }

    .element-avatar {
        ...
    }
}

2.5 杂项

• 不允许有空的规则；
• 元素选择器用小写字母；
• 去掉小数点前面的0；
  去掉数字中不必要的小数点和末尾的0；
  属性值'0'后面不要加单位；
• 同个属性不同前缀的写法需要在垂直方向保持对齐，具体参照后面的写法；
  无前缀的标准属性应该写在有前缀的属性后面；
• 不要在同个规则里出现重复的属性，如果重复的属性是连续的则没关系；
  不要在一个文件里出现两个相同的规则；
• 用 border: 0; 代替 border: none;；
• 选择器不要超过4层（在scss中如果超过4层应该考虑用嵌套的方式来写）；
• 发布的代码中不要有 @import；
• 尽量少用'*'选择器。

/* not good == 不允许有空的规则；*/
.element {
}
/* not good == 元素选择器用小写字母*/
LI {
    ...
}
/* good */
li {
    ...
}

/* not good == 去掉小数点前面的0；*/
.element {
    color: rgba(0, 0, 0, 0.5);
}
/* good */
.element {
    color: rgba(0, 0, 0, .5);
}

/* not good == 去掉数字中不必要的小数点和末尾的0；*/
.element {
    width: 50.0px;
}
/* good */
.element {
    width: 50px;
}

/* not good == 属性值'0'后面不要加单位；*/
.element {
    width: 0px;
}
/* good */
.element {
    width:;
}

/* not good
 *== 同个属性不同前缀的写法需要在垂直方向保持对齐，具体参照后面的写法；
 *== 无前缀的标准属性应该写在有前缀的属性后面；
 */
.element {
    border-radius: 3px;
    -webkit-border-radius: 3px;
    -moz-border-radius: 3px;

    background: linear-gradient(to bottom, #fff 0, #eee 100%);
    background: -webkit-linear-gradient(top, #fff 0, #eee 100%);
    background: -moz-linear-gradient(top, #fff 0, #eee 100%);
}

/* good */
.element {
    -webkit-border-radius: 3px;
       -moz-border-radius: 3px;
            border-radius: 3px;

    background: -webkit-linear-gradient(top, #fff 0, #eee 100%);
    background:    -moz-linear-gradient(top, #fff 0, #eee 100%);
    background:         linear-gradient(to bottom, #fff 0, #eee 100%);
}

/* not good == 不要在同个规则里出现重复的属性，如果重复的属性是连续的则没关系；*/
.element {
    color: rgb(0, 0, 0);
    width: 50px;
    color: rgba(0, 0, 0, .5);
}
/* good */
.element {
    color: rgb(0, 0, 0);
    color: rgba(0, 0, 0, .5);
}

/* not good == 选择器不要超过4层（在scss中如果超过4层应该考虑用嵌套的方式来写）；*/
.container . main div ul .element {
    ...
}
/* good */
.container . main .element {
    ...
}

三、结语

　　具体的规范可以参照大厂的规范文档，如下链接：

1. 腾讯AlloyTeam前端团队的CSS代码规范；
2. 百度FEX前端团队的CSS代码规范；
3. 网易的NEC前端规范；