跳到主要内容 跳到文档导航
in English

Webpack 和打包器

了解如何使用 Webpack 或其他捆绑器将 Bootstrap 包含在您的项目中。

安装引导

使用 npm将 bootstrap 安装为 Node.js 模块。

导入 JavaScript

通过将此行添加到应用程序的入口点(通常是或)来导入Bootstrap 的 JavaScriptindex.jsapp.js

// You can specify which plugins you need
import { Tooltip, Toast, Popover } from 'bootstrap';

或者,如果您只需要我们的几个插件,您可以根据需要单独导入插件

import Alert from 'bootstrap/js/dist/alert';
...

Bootstrap 依赖于属性中指定的Popper 。peerDependencies这意味着您必须确保将其添加到您的package.jsonusing npm install @popperjs/core.

导入样式

导入预编译的 Sass

要充分利用 Bootstrap 的潜力并根据您的需要对其进行自定义,请将源文件用作项目捆绑过程的一部分。

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

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

要编译 Bootstrap,请确保安装并使用所需的加载器:sass-loaderpostcss-loaderAutoprefixer。通过最少的设置,你的 webpack 配置应该包含这个规则或类似的:

// ...
{
  test: /\.(scss)$/,
  use: [{
    // inject CSS to page
    loader: 'style-loader'
  }, {
    // translates CSS into CommonJS modules
    loader: 'css-loader'
  }, {
    // Run postcss actions
    loader: 'postcss-loader',
    options: {
      // `postcssOptions` is needed for postcss 8.x;
      // if you use postcss 7.x skip the key
      postcssOptions: {
        // postcss plugins, can be exported to postcss.config.js
        plugins: function () {
          return [
            require('autoprefixer')
          ];
        }
      }
    }
  }, {
    // compiles Sass to CSS
    loader: 'sass-loader'
  }]
}
// ...

导入编译好的 CSS

或者,您可以使用 Bootstrap 的即用型 CSS,只需将此行添加到项目的入口点:

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

在这种情况下,您可以使用现有规则,css而不需要对 webpack 配置进行任何特殊修改,除非您sass-loader只需要style-loadercss-loader

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