腾讯的CSS/SCSS代码规范
2020-06-06 05:25
120 查看
腾讯的CSS/SCSS代码规范
每次打开都要等好久,干脆写出来给自己看= =
参考链接:http://alloyteam.github.io/CodeGuide/
1、空格
不需要空格
- 属性名后
- 多个规则的分隔符‘,’前
- !important ‘!’后
- 属性值中’(‘后和’)'前
- 行末不要有多余的空格
需要空格
- 属性值前
- 选择器‘>’, ‘+’, ‘~’前后
- ‘{’前
- !important ‘!’前
- @else 前后
- 属性值中的‘,’后
- 注释‘ /* ’后和 ‘ */ ’前
/* good */ .element > .dialog, .element { color: red !important; background-color: rgba(0, 0, 0, .5); } @if { ... } @else { ... }
2、空行和换行
直接看例子吧= =
/* good */ .dialog, .element { ... } .dialog { color: red; /* 属性之间需要适当的空行,具体见6、属性声明顺序 */ &:after { ... } }
3、注释
还是看代码
/* 注释统一用'/ * * /'(scss中也不要用'//') */ .modal-header { ... } /* * Modal header */ .modal-header { ... } .modal-header { /* 缩进与下一行代码保持一致 */ width: 50px; color: red; /* 可位于一个代码行的末尾,与代码间隔一个空格 */ }
4、引号
代码……
.element:after { content: ""; /* 最外层统一使用双引号 */ background-image: url("logo.png"); /* url的内容要用引号 */ } /* 属性选择器中的属性值需要引号 */ li[data-type="single"] { ... }
5、命名
/* class类名使用小写字母,以中划线分隔 */ .element-content { ... } /* idid采用驼峰式命名 */ #myDialog { ... } /* scss中的变量、函数、混合、placeholder采用驼峰式命名 */ /* 变量 */ $colorBlack: #000; /* 函数 */ @function pxToRem($px) { ... } /* 混合 */ @mixin centerBlock { ... } /* placeholder */ %myDialog { ... }
6、属性声明顺序
文末有推荐的属性的顺序
.declaration-order { display: block; float: right; position: absolute; top: 0; right: 0; bottom: 0; left: 0; z-index: 100; border: 1px solid #e5e5e5; border-radius: 3px; width: 100px; height: 100px; font: normal 13px "Helvetica Neue", sans-serif; line-height: 1.5; text-align: center; color: #333; background-color: #f5f5f5; opacity: 1; }
7、颜色
简写以及小写
.element { color: #abcdef; background-color: #012; /* #001122 */ }
8、简写
属性简写需要你非常清楚属性值的正确顺序,而且在大多数情况下并不需要设置属性简写中包含的所有值,所以建议尽量分开声明会更加清晰
注:margin 和 padding 相反,需要使用简写
9、媒体查询
尽量将媒体查询的规则靠近与他们相关的规则
10、SCSS相关
提交的代码中不要有 @debug;
声明顺序:
- @extend
- 不包含 @content 的 @include
- 包含 @content 的 @include
- 自身属性
- 嵌套规则
- @import 引入的文件不需要开头的’_‘和结尾的’.scss’;
嵌套最多不能超过5层;
@extend 中使用placeholder选择器;
去掉不必要的父级引用符号’&’。
/* not good */ @import "_dialog.scss"; /* good */ @import "dialog"; /* not good */ .fatal { @extend .error; } /* good */ .fatal { @extend %error; } /* not good */ .element { & > .dialog { ... } } /* good */ .element { > .dialog { ... } }
11、杂项
-
不允许有空的规则
-
元素选择器用小写字母
-
去掉小数点前面的0
-
去掉数字中不必要的小数点和末尾的0
-
属性值’0’后面不要加单位
-
同个属性不同前缀的写法需要在垂直方向保持对齐,具体参照右边的写法
-
无前缀的标准属性应该写在有前缀的属性后面
-
不要在同个规则里出现重复的属性,如果重复的属性是连续的则没关系
-
不要在一个文件里出现两个相同的规则
-
用 border: 0; 代替 border: none;
-
选择器不要超过4层(在scss中如果超过4层应该考虑用嵌套的方式来写)
-
发布的代码中不要有 @import
-
尽量少用’*'选择器
/* 元素选择器用小写字母 */ li { color: rgba(0, 0, 0, .5); /* 去掉小数点前面的0 */ ... } .element { width: 0; /* 属性值'0'后面不要加单位 */ } /* *同个属性不同前缀的写法需要在垂直方向保持对齐,具体参照右边的写法 *无前缀的标准属性应该写在有前缀的属性后面 */ .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%); }
没了
下面是推荐的属性的顺序
[ [ "display", "visibility", "float", "clear", "overflow", "overflow-x", "overflow-y", "clip", "zoom" ], [ "table-layout", "empty-cells", "caption-side", "border-spacing", "border-collapse", "list-style", "list-style-position", "list-style-type", "list-style-image" ], [ "-webkit-box-orient", "-webkit-box-direction", "-webkit-box-decoration-break", "-webkit-box-pack", "-webkit-box-align", "-webkit-box-flex" ], [ "position", "top", "right", "bottom", "left", "z-index" ], [ "margin", "margin-top", "margin-right", "margin-bottom", "margin-left", "-webkit-box-sizing", "-moz-box-sizing", "box-sizing", "border", "border-width", "border-style", "border-color", "border-top", "border-top-width", "border-top-style", "border-top-color", "border-right", "border-right-width", "border-right-style", "border-right-color", "border-bottom", "border-bottom-width", "border-bottom-style", "border-bottom-color", "border-left", "border-left-width", "border-left-style", "border-left-color", "-webkit-border-radius", "-moz-border-radius", "border-radius", "-webkit-border-top-left-radius", "-moz-border-radius-topleft", "border-top-left-radius", "-webkit-border-top-right-radius", "-moz-border-radius-topright", "border-top-right-radius", "-webkit-border-bottom-right-radius", "-moz-border-radius-bottomright", "border-bottom-right-radius", "-webkit-border-bottom-left-radius", "-moz-border-radius-bottomleft", "border-bottom-left-radius", "-webkit-border-image", "-moz-border-image", "-o-border-image", "border-image", "-webkit-border-image-source", "-moz-border-image-source", "-o-border-image-source", "border-image-source", "-webkit-border-image-slice", "-moz-border-image-slice", "-o-border-image-slice", "border-image-slice", "-webkit-border-image-width", "-moz-border-image-width", "-o-border-image-width", "border-image-width", "-webkit-border-image-outset", "-moz-border-image-outset", "-o-border-image-outset", "border-image-outset", "-webkit-border-image-repeat", "-moz-border-image-repeat", "-o-border-image-repeat", "border-image-repeat", "padding", "padding-top", "padding-right", "padding-bottom", "padding-left", "width", "min-width", "max-width", "height", "min-height", "max-height" ], [ "font", "font-family", "font-size", "font-weight", "font-style", "font-variant", "font-size-adjust", "font-stretch", "font-effect", "font-emphasize", "font-emphasize-position", "font-emphasize-style", "font-smooth", "line-height", "text-align", "-webkit-text-align-last", "-moz-text-align-last", "-ms-text-align-last", "text-align-last", "vertical-align", "white-space", "text-decoration", "text-emphasis", "text-emphasis-color", "text-emphasis-style", "text-emphasis-position", "text-indent", "-ms-text-justify", "text-justify", "letter-spacing", "word-spacing", "-ms-writing-mode", "text-outline", "text-transform", "text-wrap", "-ms-text-overflow", "text-overflow", "text-overflow-ellipsis", "text-overflow-mode", "-ms-word-wrap", "word-wrap", "-ms-word-break", "word-break" ], [ "color", "background", "filter:progid:DXImageTransform.Microsoft.AlphaImageLoader", "background-color", "background-image", "background-repeat", "background-attachment", "background-position", "-ms-background-position-x", "background-position-x", "-ms-background-position-y", "background-position-y", "-webkit-background-clip", "-moz-background-clip", "background-clip", "background-origin", "-webkit-background-size", "-moz-background-size", "-o-background-size", "background-size" ], [ "outline", "outline-width", "outline-style", "outline-color", "outline-offset", "opacity", "filter:progid:DXImageTransform.Microsoft.Alpha(Opacity", "-ms-filter:\\'progid:DXImageTransform.Microsoft.Alpha", "-ms-interpolation-mode", "-webkit-box-shadow", "-moz-box-shadow", "box-shadow", "filter:progid:DXImageTransform.Microsoft.gradient", "-ms-filter:\\'progid:DXImageTransform.Microsoft.gradient", "text-shadow" ], [ "-webkit-transition", "-moz-transition", "-ms-transition", "-o-transition", "transition", "-webkit-transition-delay", "-moz-transition-delay", "-ms-transition-delay", "-o-transition-delay", "transition-delay", "-webkit-transition-timing-function", "-moz-transition-timing-function", "-ms-transition-timing-function", "-o-transition-timing-function", "transition-timing-function", "-webkit-transition-duration", "-moz-transition-duration", "-ms-transition-duration", "-o-transition-duration", "transition-duration", "-webkit-transition-property", "-moz-transition-property", "-ms-transition-property", "-o-transition-property", "transition-property", "-webkit-transform", "-moz-transform", "-ms-transform", "-o-transform", "transform", "-webkit-transform-origin", "-moz-transform-origin", "-ms-transform-origin", "-o-transform-origin", "transform-origin", "-webkit-animation", "-moz-animation", "-ms-animation", "-o-animation", "animation", "-webkit-animation-name", "-moz-animation-name", "-ms-animation-name", "-o-animation-name", "animation-name", "-webkit-animation-duration", "-moz-animation-duration", "-ms-animation-duration", "-o-animation-duration", "animation-duration", "-webkit-animation-play-state", "-moz-animation-play-state", "-ms-animation-play-state", "-o-animation-play-state", "animation-play-state", "-webkit-animation-timing-function", "-moz-animation-timing-function", "-ms-animation-timing-function", "-o-animation-timing-function", "animation-timing-function", "-webkit-animation-delay", "-moz-animation-delay", "-ms-animation-delay", "-o-animation-delay", "animation-delay", "-webkit-animation-iteration-count", "-moz-animation-iteration-count", "-ms-animation-iteration-count", "-o-animation-iteration-count", "animation-iteration-count", "-webkit-animation-direction", "-moz-animation-direction", "-ms-animation-direction", "-o-animation-direction", "animation-direction" ], [ "content", "quotes", "counter-reset", "counter-increment", "resize", "cursor", "-webkit-user-select", "-moz-user-select", "-ms-user-select", "user-select", "nav-index", "nav-up", "nav-right", "nav-down", "nav-left", "-moz-tab-size", "-o-tab-size", "tab-size", "-webkit-hyphens", "-moz-hyphens", "hyphens", "pointer-events" ] ]
相关文章推荐
- CSS 符合习惯的代码规范
- 团队合作中如何写出高效整洁规范的CSS代码
- html、css代码规范
- web前端代码规范——css代码规范
- 腾讯的JavaScript代码规范
- css代码规范
- Css代码标准规范-注释
- css 代码规范
- 闭合浮动元素让CSS代码更规范
- google的html、css代码规范
- CSS 和 Sass (SCSS) 规范
- CSS代码开发规范
- 前端代码命名规范(JS\CSS\Vue)
- CSS_代码规范_书写顺序
- 编写灵活、稳定、高质量的 HTML 和 CSS 代码的规范
- 前端编码规范(4)—— CSS 和 Sass (SCSS) 规范
- css代码标准化规范
- 编写灵活、稳定、高质量的 HTML 和 CSS 代码的规范
- 腾讯C++代码规范
- 编写高质量的CSS代码,规范建议