如何从 CSS 选择器中提取 class 名称?

How to extract class names from a CSS selector?

故事:

我目前正在构建一个 ESLint 规则,以警告在 CSS 选择器定位器中使用 bootstrap 布局导向和 angular 技术 classes。目前我在字符串方法中使用一个简单的子字符串:

for (var i = 0; i < prohibitedClasses.length; i++) {
  if (node.arguments[0].value.indexOf(prohibitedClasses[i]) >= 0) {
    context.report({
      node: node,
      message: 'Unexpected Bootstrap class "' + prohibitedClasses[i] + '" inside a CSS selector'
    })
  }

但还没有被证明是可靠的。例如,它在 .col-sm-offset-11 CSS 选择器上抛出 2 次错误,报告同时使用 col-sm-offset-1col-sm-offset-11。我可以想象它可以很容易地破坏使用多个伪 classes 的更复杂的选择器。


问题:

从 CSS 选择器中提取 class 名称的最可靠 方法是什么?


这是我们应该涵盖的示例测试列表(有待改进):

.col-sm-push-4                 // -> ['col-sm-push-4']
.myclass.col-lg-pull-8         // -> ['myclass', 'col-lg-pull-8']
[class*='col-md-offset-4']     // -> []
[class$=col-md-offset-11]      // -> []
[class~="col-md-10"] .myclass  // -> ['col-md-10', 'myclass']
.col-md-10,.col-md-11          // -> ['col-md-10', 'col-md-11']

请注意,我们需要跳过 ^=$=*= 部分 class 过滤器值,留下 ~=(感谢评论) .

有一个专门为问题设计的包node-css-selector-parser,它缺少“如何使用它”部分来提取class 名称。填补空白,以下是我如何将其应用于问题。

使用 node-css-selector-parser,我们可以解析 CSS 选择器,并根据结果类型分析 class 带点的名称(例如 .myclass)和 class 属性选择器中使用的名称(例如 [class*=test]):

// setup up CSS selector parser
var CssSelectorParser = require('css-selector-parser').CssSelectorParser
var parser = new CssSelectorParser()

parser.registerSelectorPseudos('has', 'contains')
parser.registerNestingOperators('>', '+', '~')
parser.registerAttrEqualityMods('^', '$', '*', '~')
parser.enableSubstitutes()

function extractClassNames (rule) {
  var classNames = []
  // extract class names defined with ".", e.g. .myclass
  if (rule.classNames) {
    classNames.push.apply(classNames, rule.classNames)
  }

  // extract class names defined in attributes, e.g. [class*=myclass]
  if (rule.attrs) {
    rule.attrs.forEach(function (attr) {
      if (attr.name === 'class') {
        classNames.push(attr.value)
      }
    })
  }

  return classNames
}

module.exports = function (cssSelector) {
  try {
    var result = parser.parse(cssSelector)
  } catch (err) {
    // ignore parsing errors - we don't want it to fail miserably on a target machine during a ESLint run
    console.log('Parsing CSS selector: "' + cssSelector + '". ' + err)
    return []
  }

  // handling empty inputs
  if (!result) {
    return []
  }

  var classNames = []

  if (result.type === 'ruleSet') {
    var rule = result.rule
    while (rule) {
      classNames.push.apply(classNames, extractClassNames(rule))
      rule = rule.rule
    }
  } else if (result.type === 'selectors' && result.selectors) {
    result.selectors.forEach(function (selector) {
      var srule = selector.rule
      while (srule) {
        classNames.push.apply(classNames, extractClassNames(srule))
        srule = srule.rule;
      }
    })
  }
  return classNames
}

(使用standard 代码风格——因此,例如,行尾没有 ;

事实证明这对我有用,希望能帮助其他遇到类似问题的人。请注意,在此状态下,此代码还将提取传递给 ^=$=*= 的部分 class 值,理想情况下需要跳过这些值。