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

79 lines
1.5 KiB
Markdown
Raw Normal View History

2017-03-09 18:16:08 +00:00
# at-import-partial-extension-whitelist
Specify whitelist of allowed file extensions for partial names in `@import` commands.
```scss
@import "file.scss"
/** ↑
* Whitelist 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 "file.sass";
```
```scss
@import "file1", "file.stylus";
```
The following patterns are *not* considered warnings:
```scss
@import "path/fff";
```
```scss
@import "foo.scss";
```
```scss
@import "path/fff.less";
```
```scss
@import "path\\fff.ruthless";
```
```scss
@import "df/fff", '1.SCSS';
```
```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 */
```