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

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

Установка Bootstrap

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

Импорт JavaScript

Импортируйте Bootstrap’s JavaScript, добавив эту строку в точку входа вашего приложения (обычно index.js или app.js):

import 'bootstrap';

// или получить все названные экспорты для дальнейшего использования
import * as bootstrap from 'bootstrap';

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

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

// или укажите, какие плагины вам нужны:
import { Tooltip, Toast, Popover } from 'bootstrap';

Bootstrap зависит от Popper, который указан в свойстве peerDependencies. Это означает, что Вам нужно обязательно добавить его в свой package.json используя npm install @popperjs/core.

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

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

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

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

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

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

// ...
{
  test: /\.(scss)$/,
  use: [{
    // вставить CSS на страницу
    loader: 'style-loader'
  }, {
    // переводит CSS в модули CommonJS
    loader: 'css-loader'
  }, {
    // Выполнить действия postcss
    loader: 'postcss-loader',
    options: {
      // `postcssOptions` требуется для postcss 8.x;
      // если Вы используете postcss 7.x пропустите ключ
      postcssOptions: {
        // плагины postcss, можно экспортировать в postcss.config.js
        plugins: function () {
          return [
            require('autoprefixer')
          ];
        }
      }
    }
  }, {
    // компилирует Sass в CSS
    loader: 'sass-loader'
  }]
}
// ...

Импорт скомпилированного 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'
      ]
    }
  ]
}
// ...