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

70 lines
1.5 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.

# partial-no-import
Disallow non-CSS `@import`s in partial files.
```scss
// path/to/_file.scss:
/* ↑ in partial files */
@import "path/to/file.scss"
/*↑ Disallow imports */
```
The rule skips CSS files (doesn't report any `@import`s in them).
The rule also 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.
The following patterns are considered warnings:
```scss
// path/to/_file.scss:
@import "foo.scss";
```
```scss
// path/to/_file.less:
@import "path/fff.less";
```
```scss
// path/to/_file.scss:
@import "path\\fff.supa";
```
The following patterns are *not* considered warnings:
```scss
// path/to/file.scss:
@import "path/fff";
/* @import in a file that is not a partial */
```
```scss
// path/to/_file.scss:
@import url("path/_file.css"); /* has url(), so doesn't count as a partial @import */
```
```scss
// path/to/_file.scss:
@import "file.css"; /* Has ".css" extension, so doesn't count as a partial @import */
```
```scss
// path/to/_file.scss:
@import "http://_file.scss";
@import "//_file.scss";
/* Both are URIs, so don't count as partial @imports */
```
```scss
// path/to/_file.scss:
@import "file.scss" screen; /* Has a media query, so doesn't count as a partial @import */
```