Parcel 基于资源的。资源可以代表任何文件,但 Parcel 对 JavaScript ,CSS 和 HTML 文件等特定类型的资源有特殊的支持。Parcel 自动分析这些文件中引用的依赖关系,并将其包含到 输出包(output bundle) 中。相似类型的资源被组合在一起成为相同的输出包。如果您导入不同类型的资源(例如,如果你在 JS 中导入了一个 CSS 文件),它新建一个子包,并在父级中保留一个引用。这将在下面的部分中进行举例说明。
**JavaScript**
****
Web 打包器(bundler) 最传统的文件类型是 JavaScript 。Parcel 支持 CommonJS 和 ES6 模块语法来导入文件。它还支持动态 import() 函数语法来异步加载模块,这在 代码拆分 部分讨论。
~~~
// 使用 CommonJS 语法导入模块
const dep = require('./path/to/dep');
// 使用 ES6 import 语法导入模块
import dep from './path/to/dep';
~~~
你还可以在 JavaScript 文件导入非 JavaScript 资源, 例如 CSS ,甚至图像文件。当您导入其中一个文件时,它不像其他一些 打包器(bundler) 一样内联的。相反,它及其所有依赖项被放置在一个单独的包(bundle)(例如一个 CSS 文件)中。当使用 CSS Modules 时,导出的类被放置在 JavaScript 包中。其他资源类型将导出一个 URL 到 JavaScript 包的输出文件中,所以你可以在你的代码中引用它们。
~~~
// 导入一个 CSS 文件
import './test.css';
// 通过 CSS modules 导入一个 CSS 文件
import classNames from './test.css';
// 通过URL 导入一个 image 文件
import imageURL from './test.png';
~~~
如果你想将文件内联到 JavaScript 包中,而不是通过 URL 引用,你可以使用 Node.js 中的 fs.readFileSync API 来做到这一点。 URL 必须是静态可分析的,这意味着它不能有任何变量(除了 __dirname 和 __filename )。
~~~
import fs from 'fs';
// 以字符串形式读取内容
const string = fs.readFileSync(__dirname + '/test.txt', 'utf8');
// 以 缓冲区(Buffer)形式读取内容
const buffer = fs.readFileSync(__dirname + '/test.png');
~~~
**CSS**
****
CSS 资源 可以在 JavaScript 或 HTML 文件导入,并且可以通过 @import 语法包含引用的依赖关系,以及通过 url() 函数引用图像,字体等。其他的 @import 的 CSS 文件被内联到同一个 CSS 包中,并且 url() 引用被重写为它们的输出文件名。所有的文件名应该是相对于当前的 CSS 文件。
~~~
/* 导入另一个 CSS 文件 */
@import './other.css';
.test {
/* 引用一个 image 文件 */
background: url('./images/background.png');
}
~~~
除了纯 CSS ,还支持其他编译成 CSS 语言,如 LESS ,SASS 和 Stylus ,并以相同的方式工作。
**SCSS**
SCSS编译需要 node-sass 模块。可以用 npm 来安装它:
`npm install node-sass`
一旦 node-sass 安装完成,你就可以在 JavaScript 文件中导入 SCSS 文件。
`import './custom.scss'`
SCSS 文件中的依赖可以使用 @import 语句。
**HTML**
HTML 资源通常是你提供给 Parcel 的入口文件,但也可以被 JavaScript 文件引用,例如,提供其他网页的链接。脚本,样式,媒体和其他 HTML 文件的 URL 被提取和编译,如上所述。引用被重写到 HTML 中,以便它们链接到正确的输出文件。所有的文件名应该是相对于当前的 HTML 文件。
~~~
<html>
<body>
<!-- 引用一个 image 文件 -->
<img src="./images/header.png">
<a href="./other.html">Link to another page</a>
<!-- 导入一个 JavaScript 包 -->
<script src="./index.js"></script>
</body>
</html>
~~~