# loader篇

webpack 可以使用 loader 来预处理文件。这允许你打包除 JavaScript 之外的任何静态资源。你可以使用 Node.js 来很简单地编写自己的 loader。

loader的配置有三种方式:

  1. 通过在webpack配置中的module.rules配置(最推荐的方式)
// webpack.config.js
module.exports = {
	module: {
		rules: [
			{
				test: /.txt$/,
				use: 'raw-loader' // 获取到内容
			}
		]
	}
}
@前端进阶之旅: 代码已经复制到剪贴板
  1. 内联的方式(使用!将资源中的loader分开)
// 单个loader
import Styles from 'style-loader!./styles.css';

// 多个loader且带参数
import Styles from 'style-loader!css-loader?modules!./styles.css';
@前端进阶之旅: 代码已经复制到剪贴板
  1. 命令行CLI
webpack --module-bind jade-loader --module-bind 'css=style-loader!css-loader'
@前端进阶之旅: 代码已经复制到剪贴板

会对 .jade 文件使用 jade-loader,对 .css 文件使用 style-loader 和 css-loader。

以下所有教材案例GitHub地址: LinDaiDai/webpack-loader

# 文件

# raw-loader

加载文件原始内容.

例如加载text文件:

import txt from './assets/file.txt'
@前端进阶之旅: 代码已经复制到剪贴板
// webpack.config.js
module.exports = {
	module: {
		rules: [
			{
				test: /.txt$/,
				use: 'raw-loader' // 获取到内容
			}
		]
	}
}
@前端进阶之旅: 代码已经复制到剪贴板

# file-loader

将文件发送到输出文件夹,并返回(相对)URL

也就是使用了file-loader的资源文件在打包后会输出到dist文件夹中, 同时如果用import或者require引入的话获取到的是相对路径.

# 1. js代码加载图片

例如加载img文件:

import img from './assets/file.png'
@前端进阶之旅: 代码已经复制到剪贴板
// webpack.config.js
module.exports = {
	module: {
		rules: [
			{
      test: /\.(png|svg|jpg|gif)$/,
      use: [
        	 'file-loader' // 得到的是bundle中的相对路径 4sj89003nknkdsdf.png
        	}
        ]
      }
		]
	}
}
@前端进阶之旅: 代码已经复制到剪贴板

这里又一点需要注意的⚠️:

如果你是使用import引用的话得到的是图片的相对路径

如果是使用require引用的话得到的是一个模块对象, 这时候需要需要配置loader的一个参数options.esModule为false 才会得到相对路径.

// require引入
const img = require('./assets/file.png')

// 得到模块对象
Module{ defalut: '4sj89003nknkdsdf.png' }

// webpack.config.js 中配置参数
rules: [{
	loader: 'file-loader',
	options: {
		esModule: false
	}
}]
@前端进阶之旅: 代码已经复制到剪贴板

配置了esModule之后, 就能和import引入得到的一样了.

# 2. html加载图片

在html中加载一张图片:

<img src="./assets/file.png" />
@前端进阶之旅: 代码已经复制到剪贴板

这里默认应该是以CommonJS的加载方式加载的, 所以需要配置options.esModule为false, 如上面👆.

# url-loader

像 file loader 一样工作,但如果文件小于限制,可以返回 data URL

# 1. 基本用法

rules: [{
	test: /\.(png|svg|jpg|gif)$/,
	use: [{
		loader: 'url-loader'
	}]
}]
@前端进阶之旅: 代码已经复制到剪贴板
import img from './assets/file.png' // base64格式
const img from './assets/file.png' // Module: { default: data:image/png;base64... }

<img src="./assets/file.png" > // <img src="[object Module]" />
@前端进阶之旅: 代码已经复制到剪贴板

# 2. 参数limit

默认情况下它有一个参数limit是为undefined的, 此时获取文件返回的是base64格式(也就是dataURL).

但如果设置了limit(单位为K)同时文件的大小超过了这个limit的话, 就和file-loader一样返回bundle中的相对路径.

  • 不设置limit, 返回base64格式
  • 设置了limit, 小于该值, 返回base64格式
  • 设置了limit, 大于该值, 交给file-loader处理, 如果没有安装配置file-loader的话就会报错

例如加载下面👇两个img文件:

import img from './assets/file.png' // < 40KB data:image/png;base64
import wpl from './assets/wpl.png' // > 40KB 0565680d883d2c278e70d23f5ee97975.png

var imgEle = new Image()
var wplEle = new Image()
imgEle.src = img
wplEle.src = wpl
document.body.appendChild(imgEle)
document.body.appendChild(wplEle)
@前端进阶之旅: 代码已经复制到剪贴板
// webpack.config.js
module.exports = {
	module: {
		rules: [
			{
      test: /\.(png|svg|jpg|gif)$/,
      use: [
        	// 'file-loader' // 得到的是bundle中的相对路径 4sj89003nknkdsdf.png
          {
            loader: 'url-loader', // 得到的是base64格式: data:image/png;base64
            options: {
              limit: 40000 // 超过40KB则返回 4sj89003nknkdsdf.png
            }
        	}
        ]
      }
		]
	}
}
@前端进阶之旅: 代码已经复制到剪贴板

旦如果你是想直接在标签中使用一张图片的话, 例如这样:

<img src="./assets/LinDaiDai.png" />
@前端进阶之旅: 代码已经复制到剪贴板

它并不能像预期那样, 它得到的是一个对象:

这个对象长成这样:

Module{
	default: "data:image/png;base64,..."
}
@前端进阶之旅: 代码已经复制到剪贴板

所以对应页面上是不能正常显示的:

<img src="[object Module]" />
@前端进阶之旅: 代码已经复制到剪贴板

此时可以配置options中的esModule选项为false, 默认这个选项是为true的.

{
	loader: 'url-loader',
	options: {
		esModule: false
	}
}
@前端进阶之旅: 代码已经复制到剪贴板

在其他的loader, 例如raw-loader也有这样选项.

# svg-inline-loader

使用url-loader来处理svg文件, 是能将该文件转化为base64格式.

而svg-inline-loader的作用是将SVG内联为模块.

它会将引入的SVG转化为字符串.

安装:

$ cnpm i --save-dev svg-inline-loader
@前端进阶之旅: 代码已经复制到剪贴板

配置:

{
  test: /\.svg$/,
  loader: 'svg-inline-loader?classPrefix'
}
@前端进阶之旅: 代码已经复制到剪贴板

使用:

// src/print.js
const svg = require('./assets/add-icon.svg')
// import svg from './assets/add-icon.svg'

console.log(svg)
@前端进阶之旅: 代码已经复制到剪贴板

得到的是:

<svg version="1.1" id="图层_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 16 16" style=