Webpack и сборщики
Узнайте, как включить Bootstrap в свой проект с помощью Webpack или других сборщиков.
Установка Bootstrap
Установить бутстрап как модуль Node.js с помощью npm.
Импорт JavaScript
Импортируйте Bootstrap’s JavaScript, добавив эту строку в точку входа вашего приложения (обычно index.js
или app.js
):
// Вы можете указать, какие плагины Вам нужны
import { Tooltip, Toast, Popover } from 'bootstrap';
В качестве альтернативы, если Вам нужно всего несколько наших плагинов, Вы можете импортировать плагины по отдельности по мере необходимости:
import Alert from 'bootstrap/js/dist/alert';
...
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'
]
}
]
}
// ...