# SASS Guide
SASS规范指南,SASS 代码的基本规范和原则与 CSS 编码规范 (opens new window) 保持一致。
# 文档目录
# 1 编码
【强制】 使用UTF-8编码,每个SASS文件的第一行必须是定义编码的 @charset "UTF-8";
;
如果没定义编码,很有可能会出现跨平台兼容问题。
# 2 代码组织
【强制】 代码必须按如下形式按顺序组织:
- 全局的变量声明 ||
@import
; - 样式声明;
示例:
$base-font-size : 12px !default; // 字号
$base-font-family : "Hiragino Sans GB", "Microsoft Yahei", "WenQuanYi Micro Hei", sans-serif !default; // 字体族
@import "base/config";
@import "biz/page";
body {
background: #fff;
}
# 3 @import
语句
【强制】 同一个SASS文件中的所有的 @import
必须放在同一块,不允许分开:
【建议】 使用双引号引入SASS文件,至少同一项目要保持一致:
# 4 变量
【强制】 变量命名必须采用 @foo-bar 形式,不允许使用 @fooBar 形式;
示例:
/* Not so great */
$cardColor: #fff;
/* Better */
$card-color: #fff;
# 5 继承
【强制】 使用继承时,如果在声明块内书写 @extend
语句,必须写在开头;
示例:
/* Not so great */
.selector {
color: #fff;
@extend sameStyle;
}
/* Better */
.selector {
@extend sameStyle;
color: #fff;
}