注释

Sass注释在SCSS和缩进语法之间有很大的不同。这两种语法都支持两种类型的注释:使用/* */定义的注释(通常编译为CSS)和使用//不编译的注释。

SCSS

SCSS中的注释与JavaScript等其他语言中的注释工作类似。单行注释//开头,一直到行尾。单行注释被称为静默注释,因为它们不生成任何CSS语句。

多行注释以/*开头,以下一个*/结尾。如果在允许语句的地方编写了多行注释,则将其编译为CSS注释。他们也被称为显式注释(loud comment),与静默注释相呼应。编译到CSS的多行注释可能包含插值表达式,在编译注释之前将对插值表达式进行计算。

默认情况下,多行注释将在压缩模式下从已编译的CSS中删除。如果注释以/*!开头,它总是包含在CSS输出中。

SASS

缩进语法中的注释工作方式略有不同:它们是基于缩进的。与SCSS一样,使用//编写的静默注释不生成任何CSS语句,但与SCSS不同的是,在开头//下方缩进的所有内容也会被注释掉。

/·*开头的缩进语法注释以同样的方式处理缩进,只是它们会被编译为CSS。因为注释的扩展是基于缩进的,所以闭合的*/是可选的。和SCSS一样,/*可以包含插值表达式,并且可以以/*!开头在压缩模式下强制CSS输出注释。

文档注释

在使用Sass编写样式库时,可以使用注释来记录库提供[mixin.md/api/AtRules/MixinAndinclude.md)、函数变量占位符选择器,以及库本身。这些注释由SassDoc工具读取,生成漂亮的文档。查看Susy grid engine的文档,以查看它的运行情况!

文档注释是静默注释,用三个斜杠(///)直接写在文档的正上方。SassDoc将注释中的文本解析为Markdown,并支持许多有用的注释(annotations来详细描述它。

上次更新: 2019-11-5 4:49:11 PM