Перейти к основному содержанию

Webpack

Узнайте, как включить Bootstrap в свой проект с помощью Webpack или других сборщиков.

Содержание

Установка Bootstrap

Установите bootstrap как модуль Node.js с помощью npm.

Импорт JavaScript

Импортируйте JavaScript Bootstrap, добавив эту строку в точку входа вашего приложения (обычно index.js или app.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.json using npm install popper.js.

Импорт стилей

Импорт предварительно скомпилированного Sass

Чтобы использовать весь потенциал Bootstrap и настроить его в соответствии с вашими потребностями, используйте исходные файлы как часть процесса сборки вашего проекта.

Сначала создайте свою собственную _custom.scss и используйте ее для переопределения встроенных пользовательских переменных. Затем используйте ваш основной файл Sass для импорта ваших пользовательских переменных, а затем Bootstrap:

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

Чтобы Bootstrap скомпилировал, убедитесь, что вы установили и используете необходимые загрузчики: sass-loader, postcss-loader с Autoprefixer. При минимальной настройке конфигурация вашего веб-пакета должна включать это или подобное правило:

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

Импорт скомпилированного CSS

В качестве альтернативы вы можете использовать готовый к использованию CSS Bootstrap, просто добавив эту строку в точку входа вашего проекта:

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

В этом случае вы можете использовать существующее правило css без каких-либо особых изменений в конфигурации webpack, за исключением того, что вам не нужны sass-loader только style-loader и css-loader.

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