【WEBPACK v4.29.6 随缘翻译】4.资源管理

资源管理

如果你从一开始就跟着教程做, 你现在已经有一个叫做"Hello webpack"的小项目了, 现在让我们尝试处理其他的资源,像是 images,看看他们是如何被处理的。

在webpack之前, 前端开发者会使用grunt 、gulp之类的工具去处理这些资源文件, 并且把他们从/src 目录移动到 /dist 甚至是 /build 目录。 当然这个想法也同样用于处理Javascript模块, 但是像是webpack这类工具会动态构建所有依赖项目(创建之前说过的 依赖图像),这简直棒极了,因为所有模块现在显式地声明它地依赖项,这样我们就可以避免把不必要地依赖项构建到当前项目中去。

webpack最棒的一个特性是, 只要有loader,你可以包含任何类型的文件到当前模块,而不仅仅Javascript 。 这就意味着对于任何用于JavaScript的好东西(像是显式声明依赖项)可以同样接受所有东西,去构建你的网站或者app, 让我们先从css开始吧, 你可以已经对此步骤非常熟悉了。

构建

首先对我们之前使用的项目做一些微小的更改:

  <!doctype html>
  <html>
    <head>
-    <title>Getting Started</title>
+    <title>Asset Management</title>
    </head>
    <body>
-     <script src="./main.js"></script>
+     <script src="./bundle.js"></script>
    </body>
  </html>
webpack.config.js
  const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
-     filename: 'main.js',
+     filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

加载 CSS

为了将一个css 引入到JavaScript模块中, 你需要将 style-loader 以及 css-loader 安装并且添加到你的 module configuration 中:

npm install --save-dev style-loader css-loader

webpack.config.js
  const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
+   module: {
+     rules: [
+       {
+         test: /\.css$/,
+         use: [
+           'style-loader',
+           'css-loader'
+         ]
+       }
+     ]
+   }
  };
 webpack 使用常规的表达式去检测那个文件应该被查找,并且将它推送给指定的loader去处理。这样的话任何以.css 结尾的文件都会被分配给 style-loader 和 css-loader 。

这可以让你成功引入 style.css( import './style.css') 文件到需要该样式的模块中。现在一旦模块运行,一个包含字符化css的<style>会插入到html文件的 <header> 标签中。

让我们添加一个 style.css 文件到项目中并把它引入到index.js 中:

project
  webpack-demo
  |- package.json
  |- webpack.config.js
  |- /dist
    |- bundle.js
    |- index.html
  |- /src
+   |- style.css
    |- index.js
  |- /node_modules

src/style.css
.hello {
  color: red;
}
src/index.js
 import _ from 'lodash';
+ import './style.css';

  function component() {
    var element = document.createElement('div');

    // Lodash, now imported by this script
    element.innerHTML = _.join(['Hello', 'webpack'], ' ');
+   element.classList.add('hello');

    return element;
  }

  document.body.appendChild(component());

然后使用你的构建命令:

npm run build

...
    Asset      Size  Chunks             Chunk Names
bundle.js  76.4 KiB       0  [emitted]  main
Entrypoint main = bundle.js
...

在浏览器中再次打开 index.html, 你应该会看到 Hello webpack 已经被格式化为红色。 想看webpack究竟对我们的项目做了什么, 检查页面(不要看页面源文件,因为它不会给你看的(✿◡‿◡)),只需要看页面的head标签。 它一般会包含我们之前给index.js 引入的style块。

记住你可以,并且大多数情况下需要,最小化css , 为了更短时间加载完毕。在最上面, 有许多不同风格的CSS loader 供你挑选。例如 postcss, sass, less ,这里仅仅举几个例子。

加载图片

现在我们可以在项目里引入css ,但是如果我们的图片,像是背景图片或者是图标也想搞进去该怎么办呢? ——使用file-loader 我们可以同样很轻松地将他们插入到项目中:

npm install --save-dev file-loader

webpack.config.js

 const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
    module: {
      rules: [
        {
          test: /\.css$/,
          use: [
            'style-loader',
            'css-loader'
          ]
        },
+       {
+         test: /\.(png|svg|jpg|gif)$/,
+         use: [
+           'file-loader'
+         ]
+       }
      ]
    }
  };

现在,当你引入图片(import MyImage from './my-image.png'), 这个图片会被处理,并添加到你的输出目录中, 处理完毕的图片最终会生成一个url。 当像上面那样使用css-loader 的时候, 类似的处理过程会把url('./my-image.png')添加入你的CSS中。loader会把图片识别问本地文件,并且将'./my-image.png'路劲替换为最终在你输出目录下的图片路径。 html-loader 以同样的方式处理<img src="./my-image.png" />。
现在添加一个图片到我们项目中,然后看看它是怎么工作的,你可以引用任何你喜欢的图片(意味着教程不提供图片...):

project
 webpack-demo
  |- package.json
  |- webpack.config.js
  |- /dist
    |- bundle.js
    |- index.html
  |- /src
+   |- icon.png
    |- style.css
    |- index.js
  |- /node_modules
src/index.js
 import _ from 'lodash';
  import './style.css';
+ import Icon from './icon.png';

  function component() {
    var element = document.createElement('div');

    // Lodash, now imported by this script
    element.innerHTML = _.join(['Hello', 'webpack'], ' ');
    element.classList.add('hello');

+   // Add the image to our existing div.
+   var myIcon = new Image();
+   myIcon.src = Icon;
+
+   element.appendChild(myIcon);

    return element;
  }

  document.body.appendChild(component());
src/style.css
  .hello {
    color: red;
+   background: url('./icon.png');
  }

生成一个新的构建并再次打开index.html

npm run build

...
                               Asset      Size  Chunks                    Chunk Names
da4574bb234ddc4bb47cbe1ca4b20303.png  3.01 MiB          [emitted]  [big]
                           bundle.js  76.7 KiB       0  [emitted]         main
Entrypoint main = bundle.js
...

如果一切顺利,你应该会看到你的你的icon变成了一个叠加的背景图片, 就像是要给img 标签在我们的Hello webpack 下面一样(笑). 如果你观察这个元素, 你会看到它真正的面目(文件名) 已经变成像下面这个样子:
5c999da72346a995e7e2718865d019c8.png。这意味着webpack在我们的src文件夹找到了图片并且成功的处理掉了它。
一个合理的不走是最小化并且优化你的图片。 浏览 image-webpack-loader以及url-loader以查看更多关于如何加强图片加载处理的技能!

加载字体

如果要加载其他资源,像是字体呢? 文件、url loader 会处理任何你载入的文件并且输出到你的build 目录。 这就意味着我们使用它去处理任何类型的文件,包括fonts。 首先,更改一下 webpack.config.js 使得webpack具有加载字体的能力。

webpack.config.js
 const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
    module: {
      rules: [
        {
          test: /\.css$/,
          use: [
            'style-loader',
            'css-loader'
          ]
        },
        {
          test: /\.(png|svg|jpg|gif)$/,
          use: [
            'file-loader'
          ]
        },
+       {
+         test: /\.(woff|woff2|eot|ttf|otf)$/,
+         use: [
+           'file-loader'
+         ]
+       }
      ]
    }
  };

添加一些字体文件到你的项目中:

project
  webpack-demo
  |- package.json
  |- webpack.config.js
  |- /dist
    |- bundle.js
    |- index.html
  |- /src
+   |- my-font.woff
+   |- my-font.woff2
    |- icon.png
    |- style.css
    |- index.js
  |- /node_modules

设置完加载器,并且把字体放入项目后,你可以通过 @font-face 声明去写作处理。本地的 url(...) 指令会被webpack处理,就像处理image那样:

+ @font-face {
+   font-family: 'MyFont';
+   src:  url('./my-font.woff2') format('woff2'),
+         url('./my-font.woff') format('woff');
+   font-weight: 600;
+   font-style: normal;
+ }

  .hello {
    color: red;
+   font-family: 'MyFont';
    background: url('./icon.png');
  }

现在运行build命令,看看wbepack是否处理了字体文件:

npm run build

...
                                 Asset      Size  Chunks                    Chunk Names
5439466351d432b73fdb518c6ae9654a.woff2  19.5 KiB          [emitted]
 387c65cc923ad19790469cfb5b7cb583.woff  23.4 KiB          [emitted]
  da4574bb234ddc4bb47cbe1ca4b20303.png  3.01 MiB          [emitted]  [big]
                             bundle.js    77 KiB       0  [emitted]         main
Entrypoint main = bundle.js

打开index.html ,看看我们的Hello Webpack 文本是否已经被改变为新的字体。 如果一切顺利, 应该是会看到这些变化的。

加载数据

另外一个很有用的可被加载资源是data,像是JSON files , CSVs, TSVS ,以及XML。 对于JSON的支持实际上已经被内部支持,像是NodeJS一样,意味着 import Data from './data.json' 可以直接被运行。 但是如果要加载CSV , TSV,或者是XML 你可以分别使用csv-loader 以及 xml-loader,现在让我们着手处理这些吧:

npm install --save-dev csv-loader xml-loader

webpack.config.js
  const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
    module: {
      rules: [
        {
          test: /\.css$/,
          use: [
            'style-loader',
            'css-loader'
          ]
        },
        {
          test: /\.(png|svg|jpg|gif)$/,
          use: [
            'file-loader'
          ]
        },
        {
          test: /\.(woff|woff2|eot|ttf|otf)$/,
          use: [
            'file-loader'
          ]
        },
+       {
+         test: /\.(csv|tsv)$/,
+         use: [
+           'csv-loader'
+         ]
+       },
+       {
+         test: /\.xml$/,
+         use: [
+           'xml-loader'
+         ]
+       }
      ]
    }
  };

添加一些数据文件到你的项目中:

webpack-demo
  |- package.json
  |- webpack.config.js
  |- /dist
    |- bundle.js
    |- index.html
  |- /src
+   |- data.xml
    |- my-font.woff
    |- my-font.woff2
    |- icon.png
    |- style.css
    |- index.js
  |- /node_modules

src/data.xml

<?xml version="1.0" encoding="UTF-8"?>
<note>
  <to>Mary</to>
  <from>John</from>
  <heading>Reminder</heading>
  <body>Call Cindy on Tuesday</body>
</note>

现在你可以加载任何JSON, CSV,TSV,XML。 你引入的Data变量会被解析为JSON。

  import _ from 'lodash';
  import './style.css';
  import Icon from './icon.png';
+ import Data from './data.xml';

  function component() {
    var element = document.createElement('div');

    // Lodash, now imported by this script
    element.innerHTML = _.join(['Hello', 'webpack'], ' ');
    element.classList.add('hello');

    // Add the image to our existing div.
    var myIcon = new Image();
    myIcon.src = Icon;

    element.appendChild(myIcon);

+   console.log(Data);

    return element;
  }

再次运行npm run build 命令,并且打开Index.html。 如果你看了控制台(浏览器或者NODE) ,你应该可以看到你载入的data 被打印到控制台上。

  这个在实现一些数据可视化工具,例如D3 会变得非常有用。 比起在运行时请求ajax请求并且转换data, 你可以在构建的时候就将它载入你的模块, 而转换过后的数据可以在模块载入到浏览器的时候马上被使用。

全局资源

上面提到的最酷的一部分是, 使用这个方式加载模块允许你给模块和资源分组到一起,使其变得更加直观。比起依赖于包含所有资源的全局的/assets 目录, 你可以将对应的资源文件于代码分到同一个目录下。 例如,下面这个目录结构会变得非常有用:

- |- /assets
+ |– /components
+ |  |– /my-component
+ |  |  |– index.jsx
+ |  |  |– index.css
+ |  |  |– icon.svg
+ |  |  |– img.png

这个步骤让你的代码变得更“便携“ 当所有组件即将对接的时候。 加入你想把 /my-component 用于其他项目, 直接简单的复制或者移动这个目录到目标项目的/components 下。 一旦你安装了所需要的外部依赖项,以及你的配置文件中对应的loaders被定义, 你的组件应该能跑起来。

然而, 加入你已经被你那根深蒂固的观念束缚,或者你有一些资源是多个组件共享的(views, templates, modules, 等到)。 webpack依然可以将这些资源保存在根目录下, 你甚至可以使用 aliasing 让项目变得更加容易加载。

包装

下一节教程,我们不需要使用本章用到的,这些乱七八糟的资源文件。所以我们需要对其做一些清理以便我们进入下一章节。

project
 webpack-demo
  |- package.json
  |- webpack.config.js
  |- /dist
    |- bundle.js
    |- index.html
  |- /src
-   |- data.xml
-   |- my-font.woff
-   |- my-font.woff2
-   |- icon.png
-   |- style.css
    |- index.js
  |- /node_modules
webpack.config.js
const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
-   module: {
-     rules: [
-       {
-         test: /\.css$/,
-         use: [
-           'style-loader',
-           'css-loader'
-         ]
-       },
-       {
-         test: /\.(png|svg|jpg|gif)$/,
-         use: [
-           'file-loader'
-         ]
-       },
-       {
-         test: /\.(woff|woff2|eot|ttf|otf)$/,
-         use: [
-           'file-loader'
-         ]
-       },
-       {
-         test: /\.(csv|tsv)$/,
-         use: [
-           'csv-loader'
-         ]
-       },
-       {
-         test: /\.xml$/,
-         use: [
-           'xml-loader'
-         ]
-       }
-     ]
-   }
  };
src/index.js
  import _ from 'lodash';
- import './style.css';
- import Icon from './icon.png';
- import Data from './data.xml';
-
  function component() {
    var element = document.createElement('div');
-
-   // Lodash, now imported by this script
    element.innerHTML = _.join(['Hello', 'webpack'], ' ');
-   element.classList.add('hello');
-
-   // Add the image to our existing div.
-   var myIcon = new Image();
-   myIcon.src = Icon;
-
-   element.appendChild(myIcon);
-
-   console.log(Data);

    return element;
  }

本节完

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容

  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 webpack介绍和使用 一、webpack介绍 1、由来 ...
    it筱竹阅读 10,933评论 0 21
  • webpack 介绍 webpack 是什么 为什么引入新的打包工具 webpack 核心思想 webpack 安...
    yxsGert阅读 6,330评论 2 71
  • GitChat技术杂谈 前言 本文较长,为了节省你的阅读时间,在文前列写作思路如下: 什么是 webpack,它要...
    萧玄辞阅读 12,613评论 7 110
  • 目录第1章 webpack简介 11.1 webpack是什么? 11.2 官网地址 21.3 为什么使用 web...
    lemonzoey阅读 1,704评论 0 1
  • 很多单机游戏随着时间的推移,也许已经渐渐的远离我们的硬盘。但是那些带来的快乐确是真正正正不会消息的,下面这些游戏是...
    易游eu8gamecom阅读 491评论 0 0