从零开始的webpack生活-0x009：FilesLoader装载文件

0x001 概述

上一章讲的是DLL加速编译，这一章开始讲loader相关的部分，可是关于plugin的部分善未完结，由于即将要讲的ExtractTextWebpackPlugin用到了一些loader，因此以为先讲一下loder比较好。

0x002 loader介绍

我比较喜欢装载器这个翻译，loder说白了就是对各类文件的转化而已，好比json-loader能够将loader文件中的内容转化为js对象，也就是能够模拟为读取json文件而后作JSAON.parse而已，而对于其余的装载器则也相似，是对不一样文件的不一样处理方式，只是他们保持了相同的接口形式。就像一个加工的机器，有一个入口和一个出口，入口放猪肉，出来猪肉制品，入口放鸡肉，出来鸡肉制品，里面如何实现或许不同，可是操做方式基本一致。

0x003 栗子1-raw-loader：读取文件，并封装成模块，导出惟一的内容为文件内容的字符串

1. 初始化项目

   $ mkdir 0x009-loader
   $ cd 0x009-loader
   $ npm init -y
   $ cnpm install --save-dev webpack raw-loader

2. 添加配置

   const path              = require('path');
   
   module.exports = {
       entry  : {
           'index': ['./src/index.js'],
       },
       output : {
           path    : path.join(__dirname, 'dist'),
           filename: '[name].bundle.js'
       }
   };

3. 添加示例文件

   // ./srcindex.txt
   hello loader
   
   // ./src/index.j
   var content = require('raw-loader!./index.txt')
   console.log(content)

4. 打包并查看结果

   $ webpack
   // ./dist/index.js
   /***/ }),
   /* 1 */
   /***/ (function(module, exports, __webpack_require__) {
   
   var content = __webpack_require__(2)
   
   console.log(content)
   
   
   /***/ }),
   /* 2 */
   /***/ (function(module, exports) {
   
   module.exports = "hello loader"
   
   /***/ })
   /******/ ]);

   能够看到，文件的内容被以一个模块的形式导出，而在引入的文件中，变得再也不是引入一个文件，而是一个模块。

5. 不在require中使用loader，由于麻烦且不美观，咱们能够把它迁移到webpack.conf.js中。

   • 修改配置文件

     // ./wenpack.conf.js
     const path = require('path');
     
     module.exports = {
         entry : {
             'index': ['./src/index.js'],
         },
         output: {
             path    : path.join(__dirname, 'dist'),
             filename: '[name].bundle.js'
         },
         module: {
             rules: [
                 {
                     test: /\.txt$/,
                     use : 'raw-loader'
                 }
             ]
         }
     };

     • test：匹配的文件名，这里匹配后缀为.txt的，只要require了该文件名结尾的文件，都将使用这个raw-loader来处理

     • use：命中后使用的加载器

   • 查看结果，和以前一致，推荐使用wenpack配置文件形式，能够保持引入文件格式的一致性。有利于维护和美观

6. 更多配置，能够查阅webpack关于raw-loader部分。

0x004 栗子2-json-loader：将json文件转化成js对象

1. 安装依赖

$ cnpm install --save-dev json-loader

1. 添加rule配置

   {
       test: /\.json$/,
       use : loader : 'json-loader'
   }

2. 引用

   //./src/index.json
   {
     "name": "张三",
     "age": "21"
   }
   // ./src/index.js
   require('./index.json')

3. 打包并查看结果

   /* 1 */
   /***/ (function(module, exports, __webpack_require__) {
   
   __webpack_require__(2)
   
   /***/ }),
   /* 2 */
   /***/ (function(module, exports) {
   
   module.exports = {"name":"张三","age":"21"}
   
   /***/ })
   /******/ ]);

   可见，json-loder将文件内的json字符串转化成了js对象，至关于使用raw-loader获取文件内容字符串，再调用JSON.parse，而后封装成模块并导出。

0x005 栗子3-file-loader：导出文件并返回文件的URL

1. 安装依赖包

$ cnpm install --save-dev file-loader

1. 添加rule配置

   {
               test: /\.(png|jpg|gif)$/,
               use : [
                   {
                       loader : 'file-loader',
                       options: {}
                   }
               ]
           }

2. 引用

   // ./src/index.js
   var funny = require('./../res/funny.png')

3. 打包并查看结果

   $ ls ./dist
   4e4e36593ce458606ffd851043749eec.png
   index.bundle.js

   /* 1 */
   /***/ (function(module, exports, __webpack_require__) {
   
   // var content = require('raw-loader!./index.txt')
   // var content = require('./index.txt')
   
   var funny = __webpack_require__(2)
   
   
   /***/ }),
   /* 2 */
   /***/ (function(module, exports, __webpack_require__) {
   
   module.exports = __webpack_require__.p + "4e4e36593ce458606ffd851043749eec.png";
   
   /***/ })
   /******/ ]);

   能够看出，文件被导出到了dist，而且将文件的路径封装成了模块并导出。

4. option其余配置

   • name：名字

     • [path]：文件路径

     • [name]：文件名称

     • [hash]：文件hash

     • [ext]：文件后缀

     • 以上变量能够随机组合，造成文件名,推荐：[name].[hash].[ext]

5. 注意：每引入一个文件，就会生成一个模块，即使该文件只是文件名不一样，可是内容相同

6. 更多配置，能够查阅webpack关于file-loader部分。

0x006 栗子4-url-loader：根据文件大小类型判断是否DATAURL

1. 删除file-loader，添加配置

{

test: /\.(png|jpg|gif)$/,
            use : [
                {
                    loader : 'url-loader',
                    options: {
                        limit   : 1048576, // 低于1m， 这里的单位是Byte
                        mimetype: 'image/jpg', // 类型是`jpg`
                        name    : '[name].[hash].[ext]',
                        fallback: 'file-loader' //不然使用`file-loader`
                    }
                }
            ]
        }
```

1. 引入一张高于1048576的jpg图片和1张低于81920的jpg图片，还有一张png图片，da

   // 低于1048576
   require('./../res/icon.jpg')
   // 高于1048576
   require('./../res/big.jpg')

2. 打包并查看结果

   // ./dist
   big.f22f26599897a8f5003aea3d070135bf.jpg
   index.bundle.js

   // ./index.bundle.js
   
   /***/ }),
   /* 2 */
   /***/ (function(module, exports) {
   
   module.exports = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAcFBQYFBAcGBgYIBwcICx...
   tDEx6snNS15Z9DcRe9a1n/AMew+tZI/qK1rP8A49h9a1p7Es//2Q=="
   
   /***/ }),
   /* 3 */
   /***/ (function(module, exports, __webpack_require__) {
   
   module.exports = __webpack_require__.p + "big.f22f26599897a8f5003aea3d070135bf.jpg";
   
   /***/ })
   /******/ ]);

   能够看出大于1m的那个图片文件被以文件的形式导出，而小于1m的文件被以dataurl的形式封装成模块

3. 参数说明

   • limit：限制文件大小，若是小于这个数，则转化成DATAURL，若是大于这个数，则使用fallback指定的loader再次装载，若是没有配置fallback，则默认调用file-loader

   • mimetype：这个只是用来指定文件的mimetype，由于有些文件没有后缀，或者后缀和文件不符合。

   • fallback：文件超出limit以后的加载器

   • 注意：url-loader自身只有这3个参数，可是若是超出limit大小，将会执行下一个loader而且自动将配置的参数往下传，因此文中的案例的name实际上是file-loader的参数，其余loader的参数同理也能够往下传

   • 注意：这里的use其实还有另一种querystring写法，不过不推荐

     {
             test: /\.(png|jpg|gif)$/,
             use:'url-loader?limit=1045876&name=[name].[hash].[ext]'
         }

4. 更多配置，能够查阅webpack关于url-loader部分。

0x007. 资源

• 源代码