Webpack模块化

了解如何使用Webpack 2将Bootstrap包含在项目中。

什么是 Webpack?

webpack是近年来最火的一款模块加载器兼打包工具,它能把各种资源,例如JS(含JSX)、coffee、样式(含less/sass)、图片等都作为模块来使用和处理。

开发者可以直接使用 require(XXX) 的形式来引入各模块,即使它们可能需要经过编译(比如JSX和sass),但我们无须在上面花费太多心思,因为 webpack 有着各种健全的加载器(loader)在默默处理这些事情,这里有一篇《webpack 入门指南》http://www.z01.com/help/web/3209.shtml

安装 Bootstrap

使用Node.JS模块的npm命令安装 bootstrap

导入 JavaScript

通过下一行命令添加到您的应用程序的入口点(包括 Bootstrap 中的 JavaScript脚本index.jsapp.js):

import 'bootstrap';

或者,您可以根据需要 单独导入插件:

import 'bootstrap/js/dist/util';
import 'bootstrap/js/dist/dropdown';
...

Bootstrap依赖于 jQueryPopper.js,所以如果需要,npm将为您安装它们,它们必须由webpack显式提供,将以下代码添加到plugins配置文件中:

  plugins: [
    ...
      new webpack.ProvidePlugin({
        $: 'jquery',
        jQuery: 'jquery',
        'window.jQuery': 'jquery',
        Popper: ['popper.js', 'default'],
        // In case you imported plugins individually, you must also require them here:
        Util: "exports-loader?Util!bootstrap/js/dist/util",
        Dropdown: "exports-loader?Dropdown!bootstrap/js/dist/dropdown",
        ...
      })
    ...
  ]

注意,如果您选择单独导入插件,还必须安装导出加载程序

导入样式

导入预编译的Sass

要充分发挥Bootstrap的潜力,并根据您的需求进行定制,请使用源文件作为项目捆绑过程的一部分。

首先,创建自己的 _custom.scss 并使用它来覆盖 内置的自定义变量. 将您的主sass文件导入自定义变量,然后使用Bootstrap:

@import "custom";
@import "~bootstrap/scss/bootstrap";

对于Bootstrap编译,请确保安装并使用所需的加载程序:sass-loaderpostcss-loaderAutoprefixer,通过最小化安装,您的Webpack配置应该包括此规则或类似的:

  ...
  {
    test: /\.(scss)$/,
    use: [{
      loader: 'style-loader', // inject CSS to page
    }, {
      loader: 'css-loader', // translates CSS into CommonJS modules
    }, {
      loader: 'postcss-loader', // Run post css actions
      options: {
        plugins: function () { // post css plugins, can be exported to postcss.config.js
          return [
            require('precss'),
            require('autoprefixer')
          ];
        }
      }
    }, {
      loader: 'sass-loader' // compiles SASS to CSS
    }]
  },
  ...

导入编译后的 CSS

或者,您可以下面的命令简捷高效的将此行添加到项目的入口点来使用Bootstrap的即用型css:

import 'bootstrap/dist/css/bootstrap.min.css';

在这种情况下,您可以使用现有规则,css无需对webpack配置进行任何特殊修改。除非你不需要sass-loader只是样式装载机CSS-装载机

  ...
  module: {
    rules: [
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader']
      }
    ]
  }
  ...