Comments begin with the characters /* and end with the characters */. They may occur anywhere outside other tokens, and their contents have no influence on the rendering. Comments may not be nested.

  • 注释以字符 /* 开始，以字符 */ 结束
  • 注释不能嵌套
  1. /*Comment Text*/

团队约定

单行注释

注释内容第一个字符和最后一个字符都是一个空格字符，单独占一行，行与行之间相隔一行

推荐：

  1. /* Comment Text */
  2. .jdc{}
  4. /* Comment Text */
  5. .jdc{}

不推荐：

  1. /*Comment Text*/
  2. .jdc{
  3.     display: block;
  4. }
  5. .jdc{
  6.     display: block;/*Comment Text*/
  7. }

模块注释

注释内容第一个字符和最后一个字符都是一个空格字符，/* 与 模块信息描述占一行，多个横线分隔符-与*/占一行，行与行之间相隔两行

推荐：

  1. /* Module A
  2. ---------------------------------------------------------------- */
  3. .mod_a {}
  6. /* Module B
  7. ---------------------------------------------------------------- */
  8. .mod_b {}

不推荐：

  1. /* Module A ---------------------------------------------------- */
  2. .mod_a {}
  3. /* Module B ---------------------------------------------------- */
  4. .mod_b {}

文件信息注释

在样式文件编码声明 @charset 语句下面注明页面名称、作者、创建日期等信息

  1. @charset "UTF-8";
  2. /**
  3.  * @desc File Info
  4.  * @author Author Name
  5.  * @date 2015-10-10
  6.  */

更多关于CSS注释：#Comments