spaced-line-comment
在行注释中的 //
之后执行一致的间距。
(已移除)此规则在 ESLint v1.0 中移除并被 spaced-comment 所取代。
一些风格指南要求或不允许在一行注释的最初的 //
之后有一个空白。
在 //
之后留白可以使注释中的文字更容易被阅读。
另一方面,如果不在 //
后面加一个空白,注释代码就会更容易。
规则细节
这条规则将强制执行行注释//
开始后的间距的一致性。
这条规则需要两个参数。如果第一个参数是 "always"
,那么 //
后面必须至少有一个空格。
如果是 "never"
,那么后面就不应该有空格。
默认是 "always"
。
第二个参数是一个对象,有一个键,"exceptions"
。
该值是一个字符串模式的数组,被认为是规则的例外情况。
值得注意的是,如果第一个参数是 "never"
,那么例外情况将被忽略。
例外不能混合使用。
使用此规则的错误示例:
Open in Playground
// When ["never"]
// This is a comment with a whitespace at the beginning
Open in Playground
//When ["always"]
//This is a comment with no whitespace at the beginning
var foo = 5;
Open in Playground
// When ["always",{"exceptions":["-","+"]}]
//------++++++++
// Comment block
//------++++++++
使用此规则的正确示例:
Open in Playground
// When ["always"]
// This is a comment with a whitespace at the beginning
var foo = 5;
Open in Playground
//When ["never"]
//This is a comment with no whitespace at the beginning
var foo = 5;
Open in Playground
// When ["always",{"exceptions":["-"]}]
//--------------
// Comment block
//--------------
Open in Playground
// When ["always",{"exceptions":["-+"]}]
//-+-+-+-+-+-+-+
// Comment block
//-+-+-+-+-+-+-+
Related Rules
Version
This rule was introduced in ESLint v0.9.0 and removed in v1.0.0-rc-1.