notes/node_modules/stylelint-scss/src/rules/at-import-partial-extension.../README.md

71 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# at-import-partial-extension-blacklist
Specify blacklist of disallowed file extensions for partial names in `@import` commands.
```scss
@import "file.scss"
/** ↑
* Blacklist of these */
```
The rule ignores [cases](http://sass-lang.com/documentation/file.SASS_REFERENCE.html#import) when Sass considers an `@import` command just a plain CSS import:
* If the files extension is `.css`.
* If the filename begins with `http://` (or any other protocol).
* If the filename is a `url()`.
* If the `@import` has any media queries.
## Options
`array`: `["array", "of", "extensions"]`
Each value is either a string or a regexp.
Given:
```js
["scss", /less/]
```
The following patterns are considered warnings:
```scss
@import "foo.scss";
```
```scss
@import "path/fff.less";
```
```scss
@import "path\\fff.ruthless";
```
```scss
@import "df/fff", '1.SCSS';
```
The following patterns are *not* considered warnings:
```scss
@import "path/fff";
```
```scss
@import url("path/_file.css"); /* has url(), so doesn't count as a partial @import */
```
```scss
@import "file.css"; /* Has ".css" extension, so doesn't count as a partial @import */
```
```scss
/* Both are URIs, so don't count as partial @imports */
@import "http://_file.scss";
@import "//_file.scss";
```
```scss
@import "file.scss" screen; /* Has a media query, so doesn't count as a partial @import */
```