CssScss规范

结构（HTML）、表现（CSS）、行为分离（JavaScript）

编码

● 以 UTF-8 无 BOM 编码作为文件格式；

● 在HTML中文档中用

<meta charset="utf-8" />

 来指定编码；

● 为每个CSS文档显示的定义编码，在文档首行定义

@charset "utf-8";

规范

● css模块文件名必须与模块名一致，在同一个模块文件中可使用默认名称 index.css

● 命名必须由单词、中划线或数组组成

● 不允许使用拼音、尤其是缩写拼音与字母混合方式。

● 尽量不适用缩写，除非是一看就明白的单词

● 禁止使用标签选择器

● 每条规则结束后都必须加上分号

● 如果属性值为0，则不需要为0加单位

● 如果是0开始的小数，前面的0可以省略不写

●    将所有的颜色值小写、可以缩写的缩写至3位。

●    不依据表现形式来命名；

●    可根据内容来命名；

●    可根据功能来命名

不推荐：

left, right, center, red, black

推荐：

nav, aside, news, type, search

● 前缀规范

前缀	说明	实例
g-	全局通用样式命名，前缀g全称为global，一旦修改将影响全站样式	g-mod
m-	模块命名方式	m-detail
ui-	组件命名方式	ui-selector
js-	所有用于纯交互的命名，不涉及任何样式规则。JSer拥有全部定义权限	js-switch

示例

.m-detail .info { sRules; }
.m-detail .current { sRules; }
.m-detail .news { sRules; }

● 遵循先布局后内容的顺序。

.g-box {
　　　display: block;
　　　position: relative;
　　　z-index: 2;
　　　top: 10px;
　　　left: 100px;
　　　float: left;
　　　width: 500px;
　　　height: 200px;
　　　margin: 10px;
　　　padding: 10px;
　　　border: 10px solid
　　　background: #aaa;
　　　color: #000;
　　　font: 14px/1.5 sans-serif;
}

注释规范

普通注释（单行）

/* 普通注释 */

区块注释

/**
 * 模块: m-detail
 * 描述：酒店详情模块
 * 应用：page detail, info and etc...etc
 */

Scss

选择器嵌套不超过三层

CSS BEM 书写规范

BEM代表“块（block）,元素（element）,修饰符（modifier）”,我们常用这三个实体开发组件。

在选择器中，由以下三种符合来表示扩展的关系：

-   中划线 ：仅作为连字符使用，表示某个块或者某个子元素的多单词之间的连接记号。
__  双下划线：双下划线用来连接块和块的子元素
_   单下划线：单下划线用来描述一个块或者块的子元素的一种状态

type-block__element_modifier

块（block）

一个块是设计或布局的一部分，它有具体且唯一地意义 ，要么是语义上的要么是视觉上的。

在大多数情况下，任何独立的页面元素（或复杂或简单）都可以被视作一个块。它的HTML容器会有一个唯一的CSS类名，也就是这个块的名字。

针对块的CSS类名会加一些前缀（ ui- ），这些前缀在CSS中有类似命名空间的作用。

一个块的正式（实际上是半正式的）定义有下面三个基本原则：

1.  CSS中只能使用类名（不能是ID）。

2.  每一个块名应该有一个命名空间（前缀）

3.  每一条CSS规则必须属于一个块。

例如：一个自定义列表  .list 是一个块，通常自定义列表是算在 mod 类别的，在这种情况下，一个 list列表的block写法应该为: 

.list  

元素（element）

块中的子元素是块的子元素，并且子元素的子元素在 bem 里也被认为是块的直接子元素。一个块中元素的类名必须用父级块的名称作为前缀

如上面的例子，li.item  是列表的一个子元素，

.list{}
.list .item{}

.list{}
.list__item{}

修饰符（modifier）

一个“修饰符”可以理解为一个块的特定状态，标识着它持有一个特定的属性。

用一个例子来解释最好不过了。一个表示按钮的块默认有三个大小：小，中，大。为了避免创建三个不同的块，最好是在块上加修饰符。这个修饰符应该有个名字（比如：size）和值（ small，normal 或者 big ）。

如上面的例子中，表示一个选中的列表，和一个激活的列表项

.list{}
.list.select{}
.list .item{}
.list .item.active{}


.list{}
.list_select{}
.list__item{}
.list__item_active{}

LESS 书写规范

使用  .less  后缀的文件来存储变量、混合代码以及最终合并压缩。

子less	注解
lib-base.less	预定义的变量，例如颜色、字号、字体
lib-mixins.less	用于混合的代码，例如渐变、半透明的混合
lib-reset.less	初始化
lib-ui.less	颗粒化ui功能
xxx.less	模块样式

 .less 文件的引用顺序会对最终编译的样式的作用域和优先级产生影响，请尽量按照由底层到自定义的顺序来引用。

关于风格

书写原则

1.  原则上不会出现 2层以上 选择器嵌套

使用 BEM 原则，用命名来解耦，所有类名都为一层，增加效率和复用性

2.  两层选择器嵌套出现在   .mod-xxx__item_current 子元素的情况，如下:

使用推荐的嵌套写法

常规写法：

.xxx{}
.xxx__item{}
.xxx__item_current{}
// 嵌套写法
.xxx__item_current .mod-xxx__link{}

推荐：

.xxx{}
.xxx__item{}
.xxx__item_hightlight{}
.xxx__product-name{}
.xxx__link{}
.xxx__ming-zi-ke-yi-hen-chang{}

// 嵌套写法
.xxx__item_current{
    .xxx__link{}
}

对应的HTML结构如下：

<ul class="xxx">
    <li class="xxx__item">第一项
        <div class="xxx__product-name">我是名称</div>
        <span class="xxx__ming-zi-ke-yi-hen-chang">看类名</span>
        <a href="#" class="xxx__link">我是link</a>
    <li>
    <li class="xxx__item xxx__item_current">第二项 且 当前选择项
        <div class="xxx__product-name">我是名称</div>
        <a href="#" class="xxx__item-link">我是link</a>
    <li>
    <li class="xxx__item xxx__item_hightlight">第三项 且 特殊高亮
         <div class="xxx__product-name">我是名称</div>
        <a href="#" class="xxx__item-link">我是link</a>
    <li>
</ul>

BEM 解决问题

组件之间的完全解耦，不会造成命名空间的污染，如：.mod-xxx ul li 的写法带来的潜在的嵌套风险。

性能

BEM 命名会使得 Class 类名变长，但经过 gzip 压缩后这个带宽开销可以忽略不计