mirror of
https://github.com/snachodog/just-the-docs.git
synced 2025-09-14 05:43:33 -06:00
Initial commit
This commit is contained in:
83
node_modules/stylelint/lib/rules/function-url-data-uris/README.md
generated
vendored
Normal file
83
node_modules/stylelint/lib/rules/function-url-data-uris/README.md
generated
vendored
Normal file
@@ -0,0 +1,83 @@
|
||||
# function-url-data-uris
|
||||
|
||||
Require or disallow data URIs for urls.
|
||||
|
||||
```css
|
||||
a { background-image: url('data:image/gif;base64,R0lGODlh='); }
|
||||
/** ↑
|
||||
* This data URI */
|
||||
```
|
||||
|
||||
This rule ignores variables inside `url` function (`$sass`, `@less`, `--custom-property`).
|
||||
|
||||
## Options
|
||||
|
||||
`string`: `"always"|"never"`
|
||||
|
||||
### `"always"`
|
||||
|
||||
There *must always* be data URIs in url.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
background-image: url(image.gif)
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
@font-face {
|
||||
font-family: 'foo';
|
||||
src: url(foo.ttf);
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
background-image: url('data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs=')
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
@font-face {
|
||||
font-family: 'foo';
|
||||
src: url(data:font/ttf;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs=);
|
||||
}
|
||||
```
|
||||
|
||||
### `"never"`
|
||||
|
||||
There *must never* be data URIs in url.
|
||||
|
||||
The following patterns are considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
background-image: url('data:image/gif;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs=')
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
@font-face {
|
||||
font-family: 'foo';
|
||||
src: url(data:font/ttf;base64,R0lGODlhAQABAIAAAAUEBAAAACwAAAAAAQABAAACAkQBADs=);
|
||||
}
|
||||
```
|
||||
|
||||
The following patterns are *not* considered warnings:
|
||||
|
||||
```css
|
||||
a {
|
||||
background-image: url(image.gif)
|
||||
}
|
||||
```
|
||||
|
||||
```css
|
||||
@font-face {
|
||||
font-family: 'foo';
|
||||
src: url(foo.ttf);
|
||||
}
|
||||
```
|
64
node_modules/stylelint/lib/rules/function-url-data-uris/index.js
generated
vendored
Normal file
64
node_modules/stylelint/lib/rules/function-url-data-uris/index.js
generated
vendored
Normal file
@@ -0,0 +1,64 @@
|
||||
"use strict"
|
||||
|
||||
const isStandardSyntaxValue = require("../../utils/isStandardSyntaxValue")
|
||||
const isVariable = require("../../utils/isVariable")
|
||||
const report = require("../../utils/report")
|
||||
const ruleMessages = require("../../utils/ruleMessages")
|
||||
const validateOptions = require("../../utils/validateOptions")
|
||||
const valueParser = require("postcss-value-parser")
|
||||
|
||||
const ruleName = "function-url-data-uris"
|
||||
|
||||
const messages = ruleMessages(ruleName, {
|
||||
expected: "Expected a data URI",
|
||||
rejected: "Unexpected data URI",
|
||||
})
|
||||
|
||||
const rule = function (expectation) {
|
||||
return (root, result) => {
|
||||
const validOptions = validateOptions(result, ruleName, {
|
||||
actual: expectation,
|
||||
possible: [
|
||||
"always",
|
||||
"never",
|
||||
],
|
||||
})
|
||||
if (!validOptions) {
|
||||
return
|
||||
}
|
||||
|
||||
root.walkDecls(function (decl) {
|
||||
valueParser(decl.value).walk(valueNode => {
|
||||
if (valueNode.type !== "function" || valueNode.value.toLowerCase() !== "url" || !valueNode.nodes.length > 0) {
|
||||
return
|
||||
}
|
||||
|
||||
const urlValueNode = valueNode.nodes[0]
|
||||
|
||||
if (!urlValueNode.value || !isStandardSyntaxValue(urlValueNode.value) || isVariable(urlValueNode.value)) {
|
||||
return
|
||||
}
|
||||
|
||||
const valueContainDataUris = urlValueNode.value.toLowerCase().indexOf("data:") === 0
|
||||
const needUrlDataUris = expectation === "always"
|
||||
|
||||
if (valueContainDataUris && needUrlDataUris || !valueContainDataUris && !needUrlDataUris) {
|
||||
return
|
||||
}
|
||||
|
||||
const message = needUrlDataUris ? messages.expected : messages.rejected
|
||||
|
||||
report({
|
||||
message,
|
||||
node: decl,
|
||||
result,
|
||||
ruleName,
|
||||
})
|
||||
})
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
rule.ruleName = ruleName
|
||||
rule.messages = messages
|
||||
module.exports = rule
|
Reference in New Issue
Block a user