Ir para o conteúdo principal Pular para a navegação de documentos
in English

Webpack e empacotadores

Aprenda como incluir Bootstrap em seu projeto usando Webpack ou outros bundlers.

Instalando o Bootstrap

Instale o bootstrap como um módulo Node.js usando npm.

Importando JavaScript

Importe o JavaScript do Bootstrap adicionando esta linha ao ponto de entrada do seu aplicativo (geralmente index.jsou app.js):

import 'bootstrap';

// or get all of the named exports for further usage
import * as bootstrap from 'bootstrap';

Como alternativa, se você precisar apenas de alguns de nossos plugins, poderá importar os plugins individualmente conforme necessário:

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

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

Bootstrap depende de Popper , que é especificado na peerDependenciespropriedade. Isso significa que você terá que se certificar de adicioná-lo ao seu package.jsonarquivo using npm install @popperjs/core.

Importando Estilos

Importando Sass Pré-compilado

Para aproveitar todo o potencial do Bootstrap e personalizá-lo de acordo com suas necessidades, use os arquivos de origem como parte do processo de agrupamento do seu projeto.

Primeiro, crie o seu próprio _custom.scsse use-o para substituir as variáveis ​​personalizadas internas . Em seguida, use seu arquivo Sass principal para importar suas variáveis ​​personalizadas, seguido pelo Bootstrap:

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

Para o Bootstrap compilar, certifique-se de instalar e usar os carregadores necessários: sass-loader , postcss-loader com Autoprefixer . Com configuração mínima, a configuração do seu webpack deve incluir esta regra ou similar:

// ...
{
  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'
  }]
}
// ...

Importando CSS compilado

Alternativamente, você pode usar o CSS pronto para uso do Bootstrap simplesmente adicionando esta linha ao ponto de entrada do seu projeto:

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

Neste caso, você pode usar sua regra existente csssem nenhuma modificação especial na configuração do webpack, exceto que você não precisa sass-loaderapenas de style-loader e css-loader .

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