mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-09-13 21:33:32 -06:00
Initial commit
This commit is contained in:
70
node_modules/stylelint/lib/rules/selector-nested-pattern/README.md
generated
vendored
Normal file
70
node_modules/stylelint/lib/rules/selector-nested-pattern/README.md
generated
vendored
Normal file
@@ -0,0 +1,70 @@
|
||||
# selector-nested-pattern
|
||||
|
||||
Specify a pattern for the selectors of rules nested within rules.
|
||||
|
||||
```css
|
||||
a {
|
||||
color: orange;
|
||||
&:hover { color: pink; }
|
||||
} ↑
|
||||
/** ↑
|
||||
* These nested selectors */
|
||||
```
|
||||
|
||||
Non-standard selectors (e.g. selectors with Sass or Less interpolation) and selectors of rules nested within at-rules are ignored.
|
||||
|
||||
## Options
|
||||
|
||||
`regex|string`
|
||||
|
||||
A string will be translated into a RegExp — `new RegExp(yourString)` — so *be sure to escape properly*.
|
||||
|
||||
The selector value will be checked in its entirety. If you'd like to allow for combinators and commas, you must incorporate them into your pattern.
|
||||
|
||||
Given the string:
|
||||
|
||||
```js
|
||||
"^&:(?:hover|focus)$"
|
||||
```
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
.bar {}
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
.bar:hover {}
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
&:hover,
|
||||
&:focus {}
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
&:hover {}
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
&:focus {}
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
a {
|
||||
&:hover {}
|
||||
&:focus {}
|
||||
}
|
||||
```
|
61
node_modules/stylelint/lib/rules/selector-nested-pattern/index.js
generated
vendored
Normal file
61
node_modules/stylelint/lib/rules/selector-nested-pattern/index.js
generated
vendored
Normal file
@@ -0,0 +1,61 @@
|
||||
"use strict"
|
||||
|
||||
const _ = require("lodash")
|
||||
const isStandardSyntaxRule = require("../../utils/isStandardSyntaxRule")
|
||||
const isStandardSyntaxSelector = require("../../utils/isStandardSyntaxSelector")
|
||||
const report = require("../../utils/report")
|
||||
const ruleMessages = require("../../utils/ruleMessages")
|
||||
const validateOptions = require("../../utils/validateOptions")
|
||||
|
||||
const ruleName = "selector-nested-pattern"
|
||||
|
||||
const messages = ruleMessages(ruleName, {
|
||||
expected: selector => `Expected nested selector "${selector}" to match specified pattern`,
|
||||
})
|
||||
|
||||
const rule = function (pattern) {
|
||||
return (root, result) => {
|
||||
const validOptions = validateOptions(result, ruleName, {
|
||||
actual: pattern,
|
||||
possible: [
|
||||
_.isRegExp,
|
||||
_.isString,
|
||||
],
|
||||
})
|
||||
if (!validOptions) {
|
||||
return
|
||||
}
|
||||
|
||||
const normalizedPattern = _.isString(pattern) ? new RegExp(pattern) : pattern
|
||||
|
||||
root.walkRules(rule => {
|
||||
if (rule.parent.type !== "rule") {
|
||||
return
|
||||
}
|
||||
if (!isStandardSyntaxRule(rule)) {
|
||||
return
|
||||
}
|
||||
|
||||
const selector = rule.selector
|
||||
|
||||
if (!isStandardSyntaxSelector(selector)) {
|
||||
return
|
||||
}
|
||||
|
||||
if (normalizedPattern.test(selector)) {
|
||||
return
|
||||
}
|
||||
|
||||
report({
|
||||
result,
|
||||
ruleName,
|
||||
message: messages.expected(selector),
|
||||
node: rule,
|
||||
})
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
rule.ruleName = ruleName
|
||||
rule.messages = messages
|
||||
module.exports = rule
|
Reference in New Issue
Block a user