Webpack y bundlers
Aprende a incluir Bootstrap en tu proyecto usando Webpack u otros paquetes.
😎 Esta traducción es parte del proyecto esdocu.com.
Instalación de Bootstrap
Instala bootstrap como un módulo Node.js usando npm.
Importación de JavaScript
Importa el JavaScript de Bootstrap agregando esta línea
al punto de entrada de tu aplicación (normalmente index.js
o app.js
):
import 'bootstrap';
// u obtén todas las exportaciones nombradas para su uso posterior
import * as bootstrap from 'bootstrap';
Alternativamente, si solo necesitas algunos de nuestros plugins, puedes importar plugins individualmente según sea necesario:
import Alert from 'bootstrap/js/dist/alert';
// o especifica qué plugins necesitas:
import { Tooltip, Toast, Popover } from 'bootstrap';
Bootstrap depende de Popper, que se especifica en la propiedad
peerDependencies
.
Esto significa que deberás asegurarte de agregarlo a tu package.json
usando
npm install @popperjs/core
.
Importación de estilos
Importación de Sass precompilado
Para disfrutar de todo el potencial de Bootstrap y personalizarlo según tus necesidades, utiliza los archivos fuente como parte del proceso de bundling (agrupación de todos los archivos) de tu proyecto.
Primero, crea tu propio _custom.scss
y utilízalo para sobreescribir las variables personalizadas integradas. Luego, usa tu archivo Sass
principal para importar tus variables personalizadas, seguido de Bootstrap:
@import "custom";
@import "~bootstrap/scss/bootstrap";
Para que Bootstrap compile, asegúrate de instalar y usar los cargadores necesarios: sass-loader, postcss-loader con Autoprefixer. Con una configuración mínima, la configuración de tu webpack debe incluir esta regla o similar:
// ...
{
test: /\.(scss)$/,
use: [{
// inyectar CSS a la página
loader: 'style-loader'
}, {
// traduce CSS a módulos CommonJS
loader: 'css-loader'
}, {
// Ejecutar acciones postcss
loader: 'postcss-loader',
options: {
// `postcssOptions` es necesario para postcss 8.x;
// si usas postcss 7.x omite la clave
postcssOptions: {
// Plugins postcss, se pueden exportar a postcss.config.js
plugins: function () {
return [
require('autoprefixer')
];
}
}
}
}, {
// compilar Sass a CSS
loader: 'sass-loader'
}]
}
// ...
Importación de CSS compilado
Alternativamente, puedes usar el CSS listo para usar de Bootstrap simplemente agregando esta línea al punto de entrada de tu proyecto:
import 'bootstrap/dist/css/bootstrap.min.css';
En este caso, puedes usar tu regla existente para css
sin ninguna modificación especial en la
configuración de webpack, excepto que no necesitas sass-loader
solo style-loader y css-loader.
// ...
module: {
rules: [
{
test: /\.css$/,
use: [
'style-loader',
'css-loader'
]
}
]
}
// ...
😎 Esta traducción es parte del proyecto esdocu.com.