mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-09-13 13:23:32 -06:00
Initial commit
This commit is contained in:
66
node_modules/stylelint/lib/rules/declaration-property-unit-blacklist/README.md
generated
vendored
Normal file
66
node_modules/stylelint/lib/rules/declaration-property-unit-blacklist/README.md
generated
vendored
Normal file
@@ -0,0 +1,66 @@
|
||||
# declaration-property-unit-blacklist
|
||||
|
||||
Specify a blacklist of disallowed property and unit pairs within declarations.
|
||||
|
||||
```css
|
||||
a { width: 100px; }
|
||||
/** ↑ ↑
|
||||
* These properties and these units */
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
`object`: `{
|
||||
"unprefixed-property-name": ["array", "of", "units"]
|
||||
}`
|
||||
|
||||
If a property name is surrounded with `"/"` (e.g. `"/^animation/"`), it is interpreted as a regular expression. This allows, for example, easy targeting of shorthands: `/^animation/` will match `animation`, `animation-duration`, `animation-timing-function`, etc.
|
||||
|
||||
Given:
|
||||
|
||||
```js
|
||||
{
|
||||
"font-size": ["em", "px"],
|
||||
"/^animation/": ["s"]
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a { font-size: 1em; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { animation: animation-name 5s ease; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { -webkit-animation: animation-name 5s ease; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { animation-duration: 5s; }
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a { font-size: 1.2rem; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { height: 100px; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { animation: animation-name 500ms ease; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { -webkit-animation: animation-name 500ms ease; }
|
||||
```
|
||||
|
||||
```css
|
||||
a { animation-duration: 500ms; }
|
||||
```
|
77
node_modules/stylelint/lib/rules/declaration-property-unit-blacklist/index.js
generated
vendored
Normal file
77
node_modules/stylelint/lib/rules/declaration-property-unit-blacklist/index.js
generated
vendored
Normal file
@@ -0,0 +1,77 @@
|
||||
"use strict"
|
||||
|
||||
const declarationValueIndex = require("../../utils/declarationValueIndex")
|
||||
const getUnitFromValueNode = require("../../utils/getUnitFromValueNode")
|
||||
const matchesStringOrRegExp = require("../../utils/matchesStringOrRegExp")
|
||||
const report = require("../../utils/report")
|
||||
const ruleMessages = require("../../utils/ruleMessages")
|
||||
const validateOptions = require("../../utils/validateOptions")
|
||||
const _ = require("lodash")
|
||||
const valueParser = require("postcss-value-parser")
|
||||
const postcss = require("postcss")
|
||||
|
||||
const ruleName = "declaration-property-unit-blacklist"
|
||||
|
||||
const messages = ruleMessages(ruleName, {
|
||||
rejected: (property, unit) => `Unexpected unit "${unit}" for property "${property}"`,
|
||||
})
|
||||
|
||||
const rule = function (blacklist) {
|
||||
return (root, result) => {
|
||||
const validOptions = validateOptions(result, ruleName, {
|
||||
actual: blacklist,
|
||||
possible: [_.isObject],
|
||||
})
|
||||
if (!validOptions) {
|
||||
return
|
||||
}
|
||||
|
||||
root.walkDecls(decl => {
|
||||
const prop = decl.prop,
|
||||
value = decl.value
|
||||
|
||||
const unprefixedProp = postcss.vendor.unprefixed(prop)
|
||||
|
||||
const propBlacklist = _.find(blacklist, (list, propIdentifier) => matchesStringOrRegExp(unprefixedProp, propIdentifier))
|
||||
|
||||
if (!propBlacklist) {
|
||||
return
|
||||
}
|
||||
|
||||
valueParser(value).walk(function (node) {
|
||||
// Ignore wrong units within `url` function
|
||||
if (
|
||||
node.type === "function"
|
||||
&& node.value.toLowerCase() === "url"
|
||||
) {
|
||||
return false
|
||||
}
|
||||
if (node.type === "string") {
|
||||
return
|
||||
}
|
||||
|
||||
const unit = getUnitFromValueNode(node)
|
||||
|
||||
if (
|
||||
!unit
|
||||
|| unit
|
||||
&& propBlacklist.indexOf(unit.toLowerCase()) === -1
|
||||
) {
|
||||
return
|
||||
}
|
||||
|
||||
report({
|
||||
message: messages.rejected(prop, unit),
|
||||
node: decl,
|
||||
index: declarationValueIndex(decl) + node.sourceIndex,
|
||||
result,
|
||||
ruleName,
|
||||
})
|
||||
})
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
rule.ruleName = ruleName
|
||||
rule.messages = messages
|
||||
module.exports = rule
|
Reference in New Issue
Block a user