Primeiros passos
Incluindo o Bootstrap
Inclua o Bootstrap via CDN para começar rápido — o CSS vai no <head>, o bundle JS (que inclui o Popper) vai antes de </body>. O bundle.min.js inclui o Popper para tooltips/dropdowns/popovers. Com npm, importe o CSS e o JS no seu arquivo de entrada. O Bootstrap 5 abandonou a dependência do jQuery — os componentes funcionam com vanilla JS.
<!-- CSS only (in <head>) -->
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
<!-- JS bundle (before </body>) -->
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>
<!-- or install via npm -->
<!-- npm install [email protected] -->
<!-- import in JS -->
// import 'bootstrap/dist/css/bootstrap.min.css'
// import 'bootstrap' // imports all JSContainers
Containers são o elemento de layout mais básico — centralizam o conteúdo e adicionam padding horizontal. .container tem largura fixa em cada breakpoint (o max-width muda); .container-fluid é sempre 100% de largura. Containers responsivos (container-sm/md/lg/xl/xxl) são 100% de largura até o breakpoint indicado, depois viram largura fixa. Use .container para a maioria dos layouts; .container-fluid para apps de largura total.
<!-- fixed-width container (responsive breakpoints) -->
<div class="container">
<!-- content centered with max-width -->
</div>
<!-- full-width container -->
<div class="container-fluid">
<!-- spans entire viewport width -->
</div>
<!-- responsive containers (max-width at breakpoint) -->
<div class="container-sm"> <!-- 100% until sm, then fixed -->
<div class="container-md">
<div class="container-xl">
<!-- 100% wide until the breakpoint, then max-width applied -->
<div class="container-xxl">Breakpoints responsivos
O Bootstrap usa um sistema mobile-first de media queries com min-width. Há 6 breakpoints: xs (padrão), sm (576px), md (768px), lg (992px), xl (1200px), xxl (1400px). Classes como col-md-6 aplicam no md E acima. Para mostrar/ocultar em breakpoints, use d-none (display:none) e d-{breakpoint}-block. Essa abordagem mobile-first significa que você estiliza primeiro para telas pequenas e depois adiciona complexidade para as maiores.
/* Bootstrap 5 breakpoints (min-width, mobile-first) */
/* xs: <576px (default, no media query needed) */
/* sm: >=576px */
/* md: >=768px */
/* lg: >=992px */
/* xl: >=1200px */
/* xxl: >=1400px */
<!-- classes apply AT and ABOVE the breakpoint -->
<div class="col-12 col-md-6 col-lg-4">
<!-- full width on mobile, half on md, third on lg -->
</div>
<!-- hidden/visible at breakpoints -->
<div class="d-none d-md-block"> <!-- hidden below md -->
<div class="d-block d-md-none"> <!-- visible below md only -->Reboot e estilos base
O Reboot é o CSS reset do Bootstrap — normaliza os estilos dos navegadores usando unidades rem (root em, baseado no font-size de 16px do html). Os elementos recebem box-sizing: border-box. Títulos, parágrafos, listas, tabelas e links ganham defaults sensatos. O Reboot remove as margens superiores de títulos e listas, definindo-as como 0. Isso dá uma base consistente entre navegadores antes de a camada de componentes do Bootstrap entrar por cima.
<!-- Reboot normalizes styles: box-sizing, margins, etc. -->
<!-- body gets: font-family, font-size (1rem), line-height (1.5), color -->
<!-- headings use rem units, margin-top removed -->
<h1>Heading 1 (2.5rem)</h1>
<h2>Heading 2 (2rem)</h2>
<!-- links get color and underline on hover -->
<a href="#">Default link</a>
<!-- tables get basic styling -->
<table class="table">...</table>
<!-- <ul>/<ol> have padding-left removed -->
<ul>
<li>Item</li>
</ul>Personalizando com variáveis CSS
O Bootstrap 5 expõe centenas de custom properties CSS (variáveis) com prefixo --bs-. Sobrescreva-as em :root para tematizar seu site globalmente. O modo escuro é embutido via data-bs-theme='dark' no elemento <html>, que troca um conjunto de variáveis. Isso torna a tematização muito mais fácil que a antiga abordagem de variáveis Sass — você pode mudar cores, fontes, espaçamentos e raios com CSS puro, sem etapa de build.
:root {
/* override Bootstrap's CSS variables */
--bs-primary: #0d6efd;
--bs-body-bg: #ffffff;
--bs-body-color: #212529;
--bs-font-sans-serif: 'Inter', system-ui, sans-serif;
--bs-border-radius: 0.375rem;
}
/* dark mode via data attribute */
[data-bs-theme="dark"] {
--bs-body-bg: #212529;
--bs-body-color: #f8f9fa;
}
<!-- use in HTML -->
<div style="background: var(--bs-primary); color: var(--bs-white);">
Custom styled
</div>Básico de layout
Rows e colunas
.row é um container flex (display: flex) com margens horizontais negativas para compensar o padding das colunas. Os filhos .col diretos se distribuem igualmente para preencher a row. Especifique col-{1-12} para proporções fixas (de 12). Sem número, .col ocupa espaço restante igualmente. A grade de 12 colunas é o núcleo dos layouts Bootstrap — combine col-{n} e .col automático para layouts flexíveis.
<!-- .row creates a flex container with negative margins -->
<!-- .col children flex equally -->
<div class="container">
<div class="row">
<div class="col">Column 1</div>
<div class="col">Column 2</div>
<div class="col">Column 3</div>
</div>
<!-- 3 equal columns -->
</div>
<!-- sized columns -->
<div class="row">
<div class="col-8">8/12 width</div>
<div class="col-4">4/12 width</div>
</div>
<!-- auto + sized -->
<div class="row">
<div class="col">auto width (content-based)</div>
<div class="col-6">exactly half</div>
<div class="col">auto width</div>
</div>Gutters (espaço entre colunas)
Gutters são o padding entre colunas, controlado pelas classes g-* (g-0 a g-5). g-0 remove os gutters (colunas borda a borda). g-3 é o padrão. Gutters funcionam na horizontal (entre colunas) e na vertical (entre rows quando colunas quebram linha). Use variantes responsivas (g-2 g-md-4) para espaçamentos diferentes por breakpoint. O sistema de gutters substituiu a antiga abordagem de padding horizontal.
<!-- default gutters (1.5rem padding on each side of columns) -->
<div class="row">
<div class="col-6">A</div>
<div class="col-6">B</div>
</div>
<!-- remove gutters -->
<div class="row g-0">
<div class="col-6">A</div>
<div class="col-6">B</div>
</div>
<!-- custom gutter sizes: g-0 to g-5 -->
<div class="row g-3">
<div class="col-6">A</div>
<div class="col-6">B</div>
</div>
<!-- responsive gutters -->
<div class="row g-2 g-md-4">
<div class="col-6">A</div>
<div class="col-6">B</div>
</div>
<!-- vertical gutters (row spacing) -->
<div class="row g-3">
<div class="col-12">Row 1</div>
<div class="col-12">Row 2 (g-3 gap above)</div>
</div>Quebra de linha e alinhamento de colunas
As colunas quebram para uma nova linha quando o total passa de 12. Controle o alinhamento vertical com align-items-* na row (start/center/end). Controle a distribuição horizontal com justify-content-* (start/center/end/between/around/evenly). Por baixo dos panos usam flexbox. A quebra é automática — não precisa de quebras de row explícitas. Isso facilita layouts tipo masonry com apenas classes col-*.
<!-- columns wrap when they exceed 12 total -->
<div class="row">
<div class="col-9">9 cols</div>
<div class="col-4">4 cols → wraps to next line (9+4=13)</div>
<div class="col-6">6 cols (new line)</div>
</div>
<!-- vertical alignment -->
<div class="row align-items-center">
<div class="col">Vertically centered</div>
</div>
<!-- options: align-items-start, -center, -end -->
<div class="row align-items-end">...</div>
<!-- horizontal alignment -->
<div class="row justify-content-center">
<div class="col-6">Centered horizontally</div>
</div>
<!-- options: justify-content-start, -center, -end, -between, -around, -evenly -->Ordenação de colunas
Classes order reordenam colunas visualmente sem mudar o HTML. order-first, order-{1-5}, order-last fornecem 7 níveis. Use variantes responsivas (order-md-first) para mudar a ordem por breakpoint — útil para SEO (conteúdo importante primeiro no HTML) mostrando-o de forma diferente no mobile. Offsets (offset-md-4) adicionam margem à esquerda para empurrar colunas — útil para centralizar ou indentar. Ambos dependem de order e margin do flexbox.
<!-- order classes: order-first, order-{1-5}, order-last -->
<div class="row">
<div class="col order-2">First in HTML, second visually</div>
<div class="col order-1">Second in HTML, first visually</div>
<div class="col order-3">Third in both</div>
</div>
<!-- responsive ordering -->
<div class="row">
<div class="col order-last order-md-first">
Last on mobile, first on desktop
</div>
<div class="col">Normal</div>
</div>
<!-- column offset (push right) -->
<div class="row">
<div class="col-md-4 offset-md-4">Centered (offset 4)</div>
</div>
<!-- offset responsive -->
<div class="col-md-4 offset-md-2 offset-lg-4">...</div>Z-Index e empilhamento
O Bootstrap usa uma escala de z-index para empilhamento: z-1, z-2, z-3 (e negativos z-n0, z-n1, z-n2). Componentes como modals, dropdowns e tooltips têm valores de z-index embutidos mais altos (1000-1080). Para o z-index funcionar, o elemento precisa de position (relative, absolute, fixed ou sticky). Evite valores arbitrários de z-index — use a escala do Bootstrap por consistência. A ordem de empilhamento é desenhada para que modals apareçam sempre acima de dropdowns, que aparecem acima de navbars.
/* Bootstrap's z-index scale */
/* z-1 to z-3, plus z-n0, z-n1, z-n2 for negatives */
<div class="z-3 position-relative">High z-index</div>
<div class="z-1 position-relative">Low z-index</div>
<!-- components have built-in z-index: -->
/* dropdown: 1000 */
/* sticky: 1020 */
/* fixed: 1030 */
/* modal-backdrop: 1050 */
/* modal: 1055 */
/* popover: 1070 */
/* tooltip: 1080 */
<!-- use position utilities for stacking context -->
<div class="position-relative z-3">
Needs position for z-index to apply
</div>Sistema de grid
Grid básico
O grid do Bootstrap é um sistema de 12 colunas. col-{1-12} especifica quantas das 12 colunas um elemento ocupa. col-12 = largura total, col-6 = metade, col-4 = terço, col-3 = quarto. As colunas de uma row devem somar 12 (ou menos — o espaço restante é distribuído). Sem número, .col divide o espaço restante igualmente. O grid usa flexbox — rows são containers flex, colunas são flex items.
<!-- 12-column grid -->
<div class="container">
<div class="row">
<div class="col-12">Full width (12/12)</div>
</div>
<div class="row">
<div class="col-6">Half (6/12)</div>
<div class="col-6">Half (6/12)</div>
</div>
<div class="row">
<div class="col-4">Third (4/12)</div>
<div class="col-4">Third (4/12)</div>
<div class="col-4">Third (4/12)</div>
</div>
<div class="row">
<div class="col-3">Quarter (3/12)</div>
<div class="col-9">Three-quarters (9/12)</div>
</div>
</div>Colunas responsivas
Classes de coluna responsivas (col-sm-*, col-md-*, col-lg-*, col-xl-*, col-xxl-*) aplicam no breakpoint indicado E acima (mobile-first). A menor classe aplicável vence. col-12 col-md-6 col-lg-4 significa: largura total no mobile, metade em tablets, terço no desktop. row-cols-* define o número de colunas de largura igual por row num breakpoint — mais simples que especificar col-* em cada filho quando todas as colunas são iguais.
<!-- different widths at different breakpoints -->
<div class="row">
<!-- full on mobile, half on md, third on lg -->
<div class="col-12 col-md-6 col-lg-4">Card 1</div>
<div class="col-12 col-md-6 col-lg-4">Card 2</div>
<div class="col-12 col-md-6 col-lg-4">Card 3</div>
</div>
<!-- mobile-first: base class applies to all, -->
<!-- larger breakpoints override -->
<div class="col-12 col-sm-6 col-md-4 col-lg-3 col-xl-2">
1 per row on xs, 2 on sm, 3 on md, 4 on lg, 6 on xl
</div>
<!-- equal-width columns at breakpoint -->
<div class="row row-cols-1 row-cols-md-2 row-cols-lg-3">
<div class="col">Auto-width card</div>
<div class="col">Auto-width card</div>
<div class="col">Auto-width card</div>
</div>Colunas aninhadas
Para aninhar grids, coloque uma .row dentro de uma .col — a row aninhada cria um novo contexto de 12 colunas dentro da largura da coluna pai. As colunas aninhadas (col-4, col-8) dividem a largura do pai, não a página inteira. O aninhamento é essencial para layouts complexos como sidebars com subseções. Mantenha o aninhamento raso (2-3 níveis no máximo) para evitar colunas estreitas demais e preservar a legibilidade.
<!-- nest a row inside a column -->
<div class="row">
<div class="col-6">
<!-- outer column -->
<h3>Left half</h3>
<!-- nested row: new 12-column context -->
<div class="row">
<div class="col-4">Nested 1/3 of parent</div>
<div class="col-8">Nested 2/3 of parent</div>
</div>
</div>
<div class="col-6">
<h3>Right half</h3>
</div>
</div>
<!-- the nested row creates a new 12-col grid -->
<!-- within the parent column's width -->Offsets e margens de colunas
offset-{breakpoint}-{n} adiciona n colunas de margem à esquerda, útil para centralizar ou indentar. offset-md-4 num col-md-4 o centraliza (4 + 4 + 4 = 12). Para centralizar de forma mais simples, use mx-auto (margin: 0 auto), que funciona independente do número de colunas. Offsets responsivos (offset-sm-2 offset-md-0) permitem indentar no mobile mas não no desktop. Offsets são mais limpos que colunas vazias de espaçamento.
<!-- offset: add left margin (empty columns) -->
<div class="row">
<div class="col-md-4 offset-md-4">
Centered (4 + 4 offset each side = 12)
</div>
</div>
<!-- offset only on one side -->
<div class="row">
<div class="col-md-6 offset-md-3">
Centered with more left space
</div>
</div>
<!-- responsive offset -->
<div class="row">
<div class="col-sm-8 offset-sm-2 offset-md-0 col-md-12">
Offset on mobile, none on desktop
</div>
</div>
<!-- margin utilities for auto centering -->
<div class="row">
<div class="col-md-6 mx-auto">
Auto-centered (margin: 0 auto)
</div>
</div>Row columns e layout automático
row-cols-{n} define quantas colunas de largura igual por row — bem mais limpo que adicionar col-* a cada filho quando cada um tem a mesma largura. row-cols-2 significa 2 colunas por row; os itens quebram linha automaticamente. Variantes responsivas (row-cols-1 row-cols-md-3) mudam a contagem por breakpoint. .col simples (sem número) divide o espaço igualmente. Use row-cols para grids de cards; use col-{n} quando as colunas precisam de proporções específicas.
<!-- row-cols: set number of columns per row -->
<div class="row row-cols-2">
<div class="col">Item 1</div>
<div class="col">Item 2</div>
<div class="col">Item 3</div> <!-- wraps to new row -->
<div class="col">Item 4</div>
</div>
<!-- 2 per row automatically -->
<!-- responsive row-cols -->
<div class="row row-cols-1 row-cols-sm-2 row-cols-md-3 row-cols-lg-4">
<div class="col">Card</div>
<div class="col">Card</div>
<div class="col">Card</div>
<div class="col">Card</div>
</div>
<!-- auto-fit columns: .col without number -->
<div class="row">
<div class="col">Equal</div>
<div class="col">Equal</div>
<div class="col">Equal</div>
</div>
<!-- each takes 1/3, regardless of content -->Tipografia
Títulos e display
O Bootstrap estiliza h1-h6 com tamanhos em rem (h1 = 2.5rem, h6 = 1rem). As classes .h1-.h6 aplicam estilos de título a qualquer elemento. Display headings (display-1 a display-6) são maiores e mais finos — para seções hero. .lead deixa um parágrafo um pouco maior e mais leve — normalmente para o primeiro parágrafo. Títulos não têm margem superior por padrão (o Reboot remove) para evitar buracos no layout.
<!-- standard headings (h1-h6) -->
<h1>h1 heading</h1>
<h2>h2 heading</h2>
<h3>h3 heading</h3>
<!-- heading classes for matching styles -->
<p class="h1">Looks like h1</p>
<p class="h2">Looks like h2</p>
<!-- display headings (larger, thinner) -->
<h1 class="display-1">Display 1</h1>
<h1 class="display-2">Display 2</h1>
<h1 class="display-3">Display 3</h1>
<h1 class="display-4">Display 4</h1>
<h1 class="display-5">Display 5</h1>
<h1 class="display-6">Display 6</h1>
<!-- lead paragraph -->
<p class="lead">This is a lead paragraph.</p>Elementos de texto inline
O Bootstrap estiliza elementos HTML semânticos: <mark> (destaque), <del>/<s> (tachado), <ins>/<u> (sublinhado), <small> (letra miúda). Utilitários de texto fornecem estilização: text-uppercase/lowercase/capitalize, fw-bold/light/normal, fst-italic, text-muted (cinza). text-decoration-underline/line-through controlam sublinhados. Esses utilitários são preferidos a estilos inline por consistência.
<!-- text styling -->
<p>You can use <mark>highlight</mark> text.</p>
<p><del>Deleted</del> and <s>strikethrough</s> text.</p>
<p><ins>Inserted</ins> and <u>underline</u> text.</p>
<p><small>Small text</small> for fine print.</p>
<p><strong>Bold</strong> and <em>italic</em> text.</p>
<!-- text utilities -->
<p class="text-decoration-underline">Underlined</p>
<p class="text-decoration-line-through">Line through</p>
<p class="text-lowercase">lowercase text</p>
<p class="text-uppercase">UPPERCASE TEXT</p>
<p class="text-capitalize">Capitalized Text</p>
<p class="fw-bold">Font weight bold</p>
<p class="fw-light">Font weight light</p>
<p class="fst-italic">Font style italic</p>
<p class="text-muted">Muted/gray text</p>Listas
list-unstyled remove o estilo padrão de listas (bullets e padding à esquerda) — útil para menus de navegação. list-inline torna os itens de lista inline (para tag clouds, breadcrumbs). Listas de descrição (dl/dt/dd) ganham layout horizontal com a classe row — dt à esquerda, dd à direita, alinhados pelo grid. Listas no Bootstrap têm margin-top: 0 e margin-bottom: 1rem para espaçamento consistente.
<!-- unordered list -->
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
<!-- unstyled list (no bullets, no padding) -->
<ul class="list-unstyled">
<li>No bullets</li>
<li>No left padding</li>
</ul>
<!-- inline list -->
<ul class="list-inline">
<li class="list-inline-item">Inline 1</li>
<li class="list-inline-item">Inline 2</li>
<li class="list-inline-item">Inline 3</li>
</ul>
<!-- description list -->
<dl>
<dt>Term</dt>
<dd>Definition</dd>
</dl>
<!-- horizontal description list -->
<dl class="row">
<dt class="col-sm-3">Term</dt>
<dd class="col-sm-9">Definition</dd>
</dl>Blockquotes e código
Blockquotes usam a estrutura <figure>/<blockquote>/<figcaption> por semântica. blockquote-footer estiliza a citação. Estilização de código: <code> para código inline, <pre><code> para blocos de código, <kbd> para teclas, <var> para variáveis. Sempre escape os colchetes angulares no código em HTML (< para <). Blockquotes podem ser alinhados com text-center/text-end. O estilo do kbd dá às teclas uma aparência de teclado.
<!-- blockquote with source -->
<figure>
<blockquote class="blockquote">
<p>A well-known quote.</p>
</blockquote>
<figcaption class="blockquote-footer">
Someone famous in <cite title="Source Title">Source Title</cite>
</figcaption>
</figure>
<!-- blockquote alignment -->
<blockquote class="blockquote text-center">Centered</blockquote>
<blockquote class="blockquote text-end">Right-aligned</blockquote>
<!-- inline code -->
<p>Use <code><section></code> tag.</p>
<!-- code block -->
<pre><code><div class="container">
Hello
</div>
</code></pre>
<!-- variables -->
<var>y</var> = <var>mx</var> + <var>b</var>
<!-- keyboard input -->
<kbd>Ctrl</kbd> + <kbd>C</kbd>Alinhamento e quebra de texto
Alinhamento de texto: text-start/center/end (o Bootstrap 5 renomeou left/right para start/end para suportar RTL). Variantes responsivas (text-md-start) mudam o alinhamento por breakpoint. text-nowrap impede a quebra de linha; text-truncate adiciona reticências ao estourar (precisa de max-width ou container limitado). text-break quebra palavras longas. lh-* controla o line-height. Esses utilitários tratam o fluxo de texto sem CSS personalizado.
<!-- text alignment -->
<p class="text-start">Left aligned (default)</p>
<p class="text-center">Center aligned</p>
<p class="text-end">Right aligned</p>
<!-- responsive alignment -->
<p class="text-center text-md-start">
Center on mobile, left on md+
</p>
<!-- text wrapping -->
<div class="text-wrap">This text wraps.</div>
<div class="text-nowrap">This text doesn't wrap.</div>
<!-- truncate with ellipsis -->
<div class="text-truncate" style="max-width: 200px;">
This long text will be truncated with an ellipsis...
</div>
<!-- word break -->
<p class="text-break">verylongwordwithoutspaces</p>
<!-- line height -->
<p class="lh-1">Line height 1</p>
<p class="lh-sm">Line height small</p>
<p class="lh-base">Line height base (default)</p>
<p class="lh-lg">Line height large</p>Tabelas
Tabela básica
A classe .table adiciona padding, bordas e divisórias horizontais. Use <thead> para cabeçalhos, <tbody> para dados. scope='col' nos <th> do cabeçalho e scope='row' nos <th> das linhas melhoram a acessibilidade para leitores de tela. Tabelas são opt-in — sem .table você recebe tabelas HTML sem estilo. Sempre use elementos semânticos de tabela (thead, tbody, th, tr, td) por acessibilidade.
<!-- basic table with styling -->
<table class="table">
<thead>
<tr>
<th scope="col">#</th>
<th scope="col">Name</th>
<th scope="col">Email</th>
</tr>
</thead>
<tbody>
<tr>
<th scope="row">1</th>
<td>Alice</td>
<td>[email protected]</td>
</tr>
<tr>
<th scope="row">2</th>
<td>Bob</td>
<td>[email protected]</td>
</tr>
</tbody>
</table>Variantes e listrado
Modificadores de tabela: table-striped (cores alternadas nas linhas), table-bordered (todas as bordas), table-borderless (sem bordas), table-hover (destaque na linha ao passar o mouse), table-sm (padding condensado), table-dark (tema escuro). Podem ser combinados: table table-striped table-hover. A variante dark inverte as cores para fundos escuros. table-sm reduz pela metade o padding das células para exibir dados mais densos.
<!-- striped rows -->
<table class="table table-striped">
<!-- alternating background colors -->
</table>
<!-- bordered table -->
<table class="table table-bordered">
<!-- borders on all sides -->
</table>
<!-- borderless table -->
<table class="table table-borderless">
<!-- no borders -->
</table>
<!-- hoverable rows -->
<table class="table table-hover">
<!-- row highlights on hover -->
</table>
<!-- small table -->
<table class="table table-sm">
<!-- condensed padding -->
</table>
<!-- dark table -->
<table class="table table-dark">
<!-- dark background -->
</table>Cores de tabela
Aplique classes contextuais a <tr> ou <td>: table-primary, table-success, table-danger, table-warning, table-info, table-secondary, table-light, table-dark, table-active. Elas adicionam tons de fundo sutis para indicar status. Em tabelas dark, as mesmas classes fornecem variantes mais claras. Use com parcimônia para status significativos (success para concluído, danger para erros) em vez de decoração.
<!-- contextual row/cell colors -->
<table class="table">
<thead>
<tr class="table-primary"><th>Primary header</th></tr>
</thead>
<tbody>
<tr class="table-success">
<td>Success row (green)</td>
</tr>
<tr class="table-danger">
<td>Danger row (red)</td>
</tr>
<tr class="table-warning">
<td>Warning row (yellow)</td>
</tr>
<tr class="table-info">
<td>Info row (cyan)</td>
</tr>
<!-- individual cells -->
<tr>
<td class="table-active">Active cell</td>
<td>Normal cell</td>
</tr>
</tbody>
</table>Tabelas responsivas
Envolva tabelas em .table-responsive para habilitar rolagem horizontal em telas pequenas (evita quebrar o layout). table-responsive-sm/md/lg/xl/xxl rola apenas abaixo daquele breakpoint — a tabela se ajusta normalmente em telas maiores. Sem o wrapper responsivo, tabelas largas estouram o container. A div wrapper é necessária porque overflow não pode ser aplicado diretamente a <table>. Use sempre para tabelas com muitas colunas.
<!-- responsive table (horizontal scroll on small screens) -->
<div class="table-responsive">
<table class="table">
<!-- scrolls horizontally on small screens -->
<thead>...</thead>
<tbody>...</tbody>
</table>
</div>
<!-- responsive at specific breakpoints -->
<div class="table-responsive-sm">
<!-- scrolls below sm -->
</div>
<div class="table-responsive-md">
<!-- scrolls below md -->
</div>
<div class="table-responsive-lg">
<!-- scrolls below lg -->
</div>
<!-- always scrollable -->
<div class="table-responsive">...</div>Grupos de tabela e legendas
caption-top move a legenda para acima da tabela (o padrão é abaixo). Legendas melhoram a acessibilidade para leitores de tela. Estilize thead/tbody/tfoot separadamente com table-light/table-dark. Alinhamento vertical: align-top, align-middle, align-bottom em células ou linhas — útil quando as células têm alturas de conteúdo diferentes. O tfoot é estilizado como o thead por padrão, mas pode ser personalizado.
<!-- caption (accessibility, shown below table by default) -->
<table class="table caption-top">
<caption>List of users</caption>
<thead>
<tr><th>#</th><th>Name</th></tr>
</thead>
<tbody>
<tr><td>1</td><td>Alice</td></tr>
</tbody>
</table>
<!-- table groups for styling -->
<table class="table">
<thead class="table-light">
<tr><th>Light header</th></tr>
</thead>
<tbody>
<tr><td>Body</td></tr>
</tbody>
<tfoot class="table-dark">
<tr><td>Dark footer</td></tr>
</tfoot>
</table>
<!-- vertically aligned cells -->
<tr class="align-middle">
<td class="align-top">Top</td>
<td class="align-middle">Middle</td>
<td class="align-bottom">Bottom</td>
</tr>Formulários
Controles de formulário
form-control estiliza inputs de texto, textareas e inputs de arquivo. form-select estiliza dropdowns. Sempre pareie inputs com <label> (com for/id correspondentes) por acessibilidade. form-label adiciona o espaçamento adequado. disabled impede interação; readonly mostra o valor sem edição. mb-3 (margin-bottom) adiciona espaço entre grupos de formulário. A classe .form-control aplica altura, padding e estilos de foco consistentes.
<!-- text input -->
<div class="mb-3">
<label for="email" class="form-label">Email</label>
<input type="email" class="form-control" id="email" placeholder="Enter email">
</div>
<!-- textarea -->
<div class="mb-3">
<label for="bio" class="form-label">Bio</label>
<textarea class="form-control" id="bio" rows="3"></textarea>
</div>
<!-- select -->
<select class="form-select" aria-label="Default select">
<option selected>Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
</select>
<!-- disabled -->
<input class="form-control" type="text" placeholder="Disabled" disabled>
<input class="form-control" type="text" value="Readonly" readonly>Grid e layout de formulários
Use o sistema de grid (row/col) para dispor formulários. Para formulários horizontais, pareie col-form-label com col-* para alinhar label/input. row-cols-lg-auto faz os elementos do formulário se dimensionarem pelo conteúdo (formulário inline) em telas grandes. align-items-center alinha labels com inputs verticalmente. O grid dá controle preciso do layout do formulário em diferentes breakpoints sem CSS personalizado.
<!-- form using grid -->
<div class="row mb-3">
<label for="name" class="col-sm-2 col-form-label">Name</label>
<div class="col-sm-10">
<input type="text" class="form-control" id="name">
</div>
</div>
<!-- inline form -->
<form class="row row-cols-lg-auto g-3 align-items-center">
<div class="col">
<input class="form-control" placeholder="Email">
</div>
<div class="col">
<input class="form-control" placeholder="Password">
</div>
<div class="col">
<button type="submit" class="btn btn-primary">Sign in</button>
</div>
</form>
<!-- horizontal form with column sizing -->
<form>
<div class="row mb-3">
<label class="col-2 col-form-label">Email</label>
<div class="col-10">
<input class="form-control" type="email">
</div>
</div>
</form>Input groups
Input groups antepõem ou anexam textos/botões aos inputs usando input-group-text. Comum para @ de usuários, $ de moeda, .00 de decimais ou botões de busca. O wrapper input-group faz o addon e o input parecerem um controle único. Múltiplos inputs podem compartilhar um addon. Botões dentro de input groups usam btn-outline-* para visual conectado. Não misture input groups com form-floating.
<!-- prepend text -->
<div class="input-group mb-3">
<span class="input-group-text">@</span>
<input type="text" class="form-control" placeholder="Username">
</div>
<!-- append text -->
<div class="input-group mb-3">
<input type="text" class="form-control" placeholder="Recipient's username">
<span class="input-group-text">@example.com</span>
</div>
<!-- prepend + append -->
<div class="input-group mb-3">
<span class="input-group-text">$</span>
<input type="text" class="form-control">
<span class="input-group-text">.00</span>
</div>
<!-- with button -->
<div class="input-group mb-3">
<input type="text" class="form-control" placeholder="Search">
<button class="btn btn-outline-secondary" type="button">Go</button>
</div>
<!-- multiple inputs -->
<div class="input-group">
<span class="input-group-text">First and last name</span>
<input type="text" class="form-control">
<input type="text" class="form-control">
</div>Floating labels
Floating labels animam o label de dentro do input para acima dele quando o campo recebe foco ou tem conteúdo. O label deve vir DEPOIS do input no HTML. Um atributo placeholder é obrigatório (mesmo vazio) para o comportamento flutuante. Esse padrão economiza espaço e tem aparência moderna. Não combine com input-group. Floating labels funcionam com inputs, textareas e selects. São uma alternativa limpa aos labels tradicionais em formulários compactos.
<!-- floating label (label floats up when focused/filled) -->
<div class="form-floating mb-3">
<input type="email" class="form-control" id="floatingInput" placeholder="[email protected]">
<label for="floatingInput">Email address</label>
</div>
<!-- floating textarea -->
<div class="form-floating">
<textarea class="form-control" id="floatingTextarea" placeholder="Leave a comment"></textarea>
<label for="floatingTextarea">Comments</label>
</div>
<!-- floating select -->
<div class="form-floating mb-3">
<select class="form-select" id="floatingSelect">
<option selected>Open this select menu</option>
<option value="1">One</option>
</select>
<label for="floatingSelect">Works with selects</label>
</div>
<!-- note: placeholder is REQUIRED for floating labels -->
<!-- the placeholder="..." must be present -->Validação
O Bootstrap fornece as classes is-valid e is-invalid para estilização de validação, com valid-feedback e invalid-feedback para mensagens. A classe needs-validation num formulário, combinada com novalidate (desativa os balões do navegador), permite usar a UI de validação do Bootstrap com JS personalizado. No submit, adicione was-validated para mostrar os estados de validação. Funciona com restrições HTML5 (required, pattern, type) ou validação personalizada no servidor.
<!-- server-side validation classes -->
<div class="mb-3">
<label for="username" class="form-label">Username</label>
<input type="text" class="form-control is-valid" id="username" value="valid_user">
<div class="valid-feedback">Looks good!</div>
</div>
<div class="mb-3">
<label for="email" class="form-label">Email</label>
<input type="email" class="form-control is-invalid" id="email">
<div class="invalid-feedback">Please enter a valid email.</div>
</div>
<!-- no validate on form to disable browser validation -->
<form class="needs-validation" novalidate>
<div class="mb-3">
<input type="text" class="form-control" required>
<div class="invalid-feedback">This field is required.</div>
</div>
<button class="btn btn-primary" type="submit">Submit</button>
</form>
<!-- JS: form.classList.add('was-validated') on submit -->Cards
Card básico
Cards são containers flexíveis com header, body e footer opcionais. card-img-top coloca uma imagem no topo. card-title, card-subtitle, card-text estilizam o conteúdo. A largura é controlada pelo grid pai ou um atributo style — cards por padrão ocupam a largura total. card-header e card-footer servem para conteúdo estruturado. Os cards substituíram panels, wells e thumbnails do Bootstrap 3 por um componente unificado.
<div class="card" style="width: 18rem;">
<!-- optional image -->
<img src="..." class="card-img-top" alt="...">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<h6 class="card-subtitle mb-2 text-muted">Card subtitle</h6>
<p class="card-text">Some quick example text to build on the card title.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
</div>
<!-- card sections -->
<div class="card">
<div class="card-header">Header</div>
<div class="card-body">Body content</div>
<div class="card-footer text-muted">Footer</div>
</div>Tipos de conteúdo do card
Cards podem conter vários tipos de conteúdo: imagens, texto, list groups (use list-group-flush para remover bordas e casar com as bordas do card) e links (card-link adiciona espaçamento). Misture seções — card-body, list-group, card-header, card-footer — para construir o card exato que precisa. list-group-flush integra listas perfeitamente nos cards sem bordas duplas. Essa flexibilidade faz dos cards o componente mais versátil do Bootstrap.
<!-- list group inside card -->
<div class="card" style="width: 18rem;">
<div class="card-header">Featured</div>
<ul class="list-group list-group-flush">
<li class="list-group-item">Item 1</li>
<li class="list-group-item">Item 2</li>
<li class="list-group-item">Item 3</li>
</ul>
<div class="card-body">
<a href="#" class="card-link">Card link</a>
<a href="#" class="card-link">Another link</a>
</div>
</div>
<!-- kitchen sink (all content types) -->
<div class="card">
<img src="..." class="card-img-top">
<div class="card-body">
<h5 class="card-title">Title</h5>
<p class="card-text">Text</p>
</div>
<ul class="list-group list-group-flush">
<li class="list-group-item">List item</li>
</ul>
<div class="card-body">
<a href="#" class="card-link">Link</a>
</div>
</div>Grid e grupos de cards
card-group conecta cards com bordas compartilhadas e alturas iguais. Para grids de cards responsivos, use o sistema de grid: row row-cols-1 row-cols-md-3 g-4 dá 1 coluna no mobile, 3 no desktop, com espaçamento gap-4. Cada card vai numa .col. A abordagem de grid é mais flexível que card-group — cards podem ter alturas independentes e você controla a quebra de linha. Use card-group só quando precisar de cards conectados e de mesma altura.
<!-- card group (cards share border, equal height) -->
<div class="card-group">
<div class="card">
<img src="..." class="card-img-top">
<div class="card-body">
<h5 class="card-title">Card 1</h5>
</div>
</div>
<div class="card">
<div class="card-body">
<h5 class="card-title">Card 2</h5>
</div>
</div>
<div class="card">
<div class="card-body">
<h5 class="card-title">Card 3</h5>
</div>
</div>
</div>
<!-- cards have equal height, connected borders -->
<!-- using grid for responsive card layout -->
<div class="row row-cols-1 row-cols-md-3 g-4">
<div class="col">
<div class="card">...</div>
</div>
<div class="col">
<div class="card">...</div>
</div>
</div>Navegação em cards
Adicione navegação aos cards com nav-tabs ou nav-pills no card-header. card-header-tabs e card-header-pills integram a nav rente às bordas do header. Use nav-link active para a aba atual, nav-link disabled para inativas. Para tornar as abas funcionais (trocar conteúdo), adicione data-bs-toggle='tab' e painéis de tab — o JS do Bootstrap cuida da troca. Esse padrão é comum em dashboards e cards de conteúdo com múltiplas views.
<!-- card with nav tabs -->
<div class="card text-center">
<div class="card-header">
<ul class="nav nav-tabs card-header-tabs">
<li class="nav-item">
<a class="nav-link active" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled">Disabled</a>
</li>
</ul>
</div>
<div class="card-body">
<h5 class="card-title">Special title</h5>
<p class="card-text">Content for active tab.</p>
<a href="#" class="btn btn-primary">Go</a>
</div>
</div>
<!-- card with pills -->
<div class="card-header">
<ul class="nav nav-pills card-header-pills">
<li class="nav-item"><a class="nav-link active" href="#">Active</a></li>
</ul>
</div>Variantes e overlay de card
Variantes de cor de card: bg-{color} com text-white/text-dark para fundos sólidos; border-{color} com text-{color} para bordas coloridas. card-img-overlay coloca texto sobre uma imagem (card-img preenche o card, o conteúdo do overlay fica por cima) — use text-bg-dark para texto legível sobre imagens. text-center/text-start/text-end controlam o alinhamento do texto. Em overlays sobre imagens escuras, garanta contraste suficiente entre texto e imagem.
<!-- colored card -->
<div class="card text-white bg-primary">
<div class="card-header">Header</div>
<div class="card-body">
<h5 class="card-title">Primary card</h5>
<p class="card-text">Text on colored background.</p>
</div>
</div>
<!-- border colored card -->
<div class="card border-primary">
<div class="card-header border-primary">Header</div>
<div class="card-body text-primary">
<h5 class="card-title">Primary border</h5>
</div>
</div>
<!-- image overlay (text over image) -->
<div class="card text-bg-dark">
<img src="..." class="card-img">
<div class="card-img-overlay">
<h5 class="card-title">Overlay title</h5>
<p class="card-text">Text over the image.</p>
</div>
</div>
<!-- text alignment -->
<div class="card text-center">Centered text</div>
<div class="card text-end">Right-aligned</div>Modals
Modal básico
Modals são disparados por data-bs-toggle='modal' com data-bs-target apontando para o id do modal. Estrutura: modal > modal-dialog > modal-content > modal-header/body/footer. btn-close é o botão X (data-bs-dismiss='modal'). fade adiciona transição. tabindex='-1' e aria-hidden servem à acessibilidade. O modal fica oculto por padrão e posicionado com position fixed. O JS do Bootstrap cuida de mostrar, ocultar, backdrop e gerenciamento de foco.
<!-- Button to trigger -->
<button type="button" class="btn btn-primary" data-bs-toggle="modal"
data-bs-target="#exampleModal">
Launch demo modal
</button>
<!-- Modal -->
<div class="modal fade" id="exampleModal" tabindex="-1"
aria-labelledby="exampleModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="exampleModalLabel">Modal title</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal"
aria-label="Close"></button>
</div>
<div class="modal-body">
Modal body text goes here.
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div>
</div>
</div>Tamanho e rolagem do modal
Tamanhos de modal: modal-sm, padrão, modal-lg, modal-xl, modal-fullscreen. modal-fullscreen-{breakpoint}-down é tela cheia só abaixo daquele breakpoint. modal-dialog-scrollable faz o corpo rolar (header/footer ficam fixos) — essencial para conteúdo longo. modal-dialog-centered centraliza o modal verticalmente. Essas classes vão no modal-dialog. Combine: modal-dialog modal-dialog-centered modal-dialog-scrollable para um modal centralizado e rolável.
<!-- sizes -->
<div class="modal-dialog modal-sm">Small</div>
<div class="modal-dialog">Default</div>
<div class="modal-dialog modal-lg">Large</div>
<div class="modal-dialog modal-xl">Extra large</div>
<div class="modal-dialog modal-fullscreen">Fullscreen</div>
<!-- responsive fullscreen -->
<div class="modal-dialog modal-fullscreen-sm-down">
<!-- fullscreen below sm, normal above -->
</div>
<!-- scrollable long content -->
<div class="modal-dialog modal-dialog-scrollable">
<div class="modal-content">
<div class="modal-body">
<!-- long content scrolls within modal -->
</div>
</div>
</div>
<!-- vertically centered -->
<div class="modal-dialog modal-dialog-centered">
<!-- centered vertically in viewport -->
</div>Modal via JavaScript
Controle modals via JS: crie uma instância com new bootstrap.Modal(el), depois show()/hide()/toggle(). backdrop: 'static' impede fechar ao clicar no backdrop; keyboard: false desativa o Esc. Eventos: show.bs.modal, shown.bs.modal, hide.bs.modal, hidden.bs.modal (show = começando, shown = terminado). Use shown.bs.modal para focar um input ou carregar conteúdo dinâmico. O backdrop static é útil para formulários em que o fechamento acidental perde dados.
<!-- HTML modal (hidden) -->
<div class="modal fade" id="myModal" tabindex="-1">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-body">Dynamic content here</div>
</div>
</div>
</div>
<script>
// create modal instance
const modalEl = document.getElementById('myModal')
const modal = new bootstrap.Modal(modalEl)
// show
modal.show()
// hide
modal.hide()
// toggle
modal.toggle()
// handle events
modalEl.addEventListener('shown.bs.modal', () => {
console.log('modal fully shown')
})
modalEl.addEventListener('hidden.bs.modal', () => {
console.log('modal fully hidden')
})
// pass options
const modal = new bootstrap.Modal(modalEl, {
backdrop: 'static', // don't close on backdrop click
keyboard: false // don't close on Esc
})
</script>Tooltips e popovers
Tooltips aparecem ao hover/focus; popovers ao clique. Ambos precisam de inicialização JS (o Bootstrap não auto-inicializa por desempenho). data-bs-placement define a posição (top/bottom/left/right). Popovers têm title + content; data-bs-html='true' permite HTML. data-bs-trigger='focus' torna os popovers dispensáveis (clique fora). Tooltips e popovers usam Popper.js (incluído no bundle) para posicionamento inteligente. São ideais para dicas, definições e informação contextual.
<!-- tooltip (hover/focus) -->
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip"
data-bs-placement="top" title="Tooltip on top">
Hover me
</button>
<!-- positions: top, bottom, left, right -->
<button data-bs-toggle="tooltip" data-bs-placement="right"
title="Right tooltip">Right</button>
<!-- popover (click) -->
<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover"
title="Popover title" data-bs-content="Content here">
Click to toggle popover
</button>
<!-- popover with HTML content -->
<button data-bs-toggle="popover" data-bs-html="true"
data-bs-content="<b>Bold</b> content">HTML popover</button>
<!-- dismissible popover -->
<button data-bs-toggle="popover" data-bs-trigger="focus"
title="Dismissible">Click outside to dismiss</button>
<script>
// MUST initialize tooltips and popovers
const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]')
tooltipTriggerList.forEach(t => new bootstrap.Tooltip(t))
const popoverTriggerList = document.querySelectorAll('[data-bs-toggle="popover"]')
popoverTriggerList.forEach(p => new bootstrap.Popover(p))
</script>Offcanvas (gaveta)
Offcanvas é uma gaveta deslizante (como um modal, mas a partir da borda). offcanvas-start/end/top/bottom define a direção do deslizamento. A estrutura espelha o modal: offcanvas-header/body com btn-close. data-bs-backdrop='static' impede fechar ao clicar no backdrop. text-bg-dark para a variante escura. Offcanvas é ideal para navegação mobile, filtros ou painéis laterais. Diferente dos modals, não cobre a tela inteira — é uma gaveta de overlay. Substitua navbar-collapse por offcanvas para menus mobile modernos.
<!-- trigger button -->
<button class="btn btn-primary" data-bs-toggle="offcanvas"
data-bs-target="#demoOffcanvas">
Open offcanvas
</button>
<!-- offcanvas drawer -->
<div class="offcanvas offcanvas-start" tabindex="-1" id="demoOffcanvas">
<div class="offcanvas-header">
<h5 class="offcanvas-title">Title</h5>
<button type="button" class="btn-close" data-bs-dismiss="offcanvas"></button>
</div>
<div class="offcanvas-body">
<p>Content for the offcanvas.</p>
</div>
</div>
<!-- positions: start (left), end (right), top, bottom -->
<div class="offcanvas offcanvas-end" id="rightDrawer">Right side</div>
<div class="offcanvas offcanvas-top" id="topDrawer">Top</div>
<!-- dark variant -->
<div class="offcanvas offcanvas-start text-bg-dark" id="darkDrawer">
Dark offcanvas
</div>
<!-- static backdrop (no close on click outside) -->
<div class="offcanvas" data-bs-backdrop="static">...</div>Alertas
Alertas básicos
Alerts exibem mensagens de feedback contextuais. alert-{variant} define a cor (primary, success, danger, warning, info, light, dark). role='alert' serve à acessibilidade de leitores de tela. alert-link estiliza links para casar com a cor do alerta. Use alerts para: feedback de validação de formulário, resultados de ações (salvo! excluído!) ou avisos importantes. Escolha cores semanticamente: success para positivo, danger para erros, warning para atenção, info para informação neutra.
<!-- alert variants -->
<div class="alert alert-primary" role="alert">Primary alert</div>
<div class="alert alert-secondary" role="alert">Secondary alert</div>
<div class="alert alert-success" role="alert">Success! Well done.</div>
<div class="alert alert-danger" role="alert">Danger! Something went wrong.</div>
<div class="alert alert-warning" role="alert">Warning! Check this.</div>
<div class="alert alert-info" role="alert">Info! Note this.</div>
<div class="alert alert-light" role="alert">Light alert</div>
<div class="alert alert-dark" role="alert">Dark alert</div>
<!-- with link -->
<div class="alert alert-primary" role="alert">
This is an alert with <a href="#" class="alert-link">a link</a>.
</div>Alertas dispensáveis
alert-dismissible adiciona padding para o botão de fechar; btn-close com data-bs-dismiss='alert' fecha. fade show habilita a transição de fade-out. Uma vez dispensado, o alerta é removido do DOM (não apenas oculto). Via JS, crie uma instância de Alert e chame close(). O evento closed.bs.alert dispara após a remoção. Para mostrar de novo, é preciso recriar o elemento DOM. Para dispensas persistentes (não mostrar de novo), guarde o estado no localStorage.
<!-- dismissible alert -->
<div class="alert alert-warning alert-dismissible fade show" role="alert">
<strong>Holy guacamole!</strong> You should check in on some of those fields.
<button type="button" class="btn-close" data-bs-dismiss="alert"
aria-label="Close"></button>
</div>
<!-- needs these classes:
- alert-dismissible: adds padding for close button
- fade show: enables transition
<!-- after dismissal, the alert is removed from DOM -->
<!-- via JavaScript -->
<script>
const alertEl = document.querySelector('.alert')
const alert = new bootstrap.Alert(alertEl)
alert.close() // closes and removes
</script>
<!-- events -->
alertEl.addEventListener('closed.bs.alert', () => {
console.log('alert was closed and removed')
})
</script>Alertas com ícones e conteúdo
Alerts podem conter conteúdo rico: títulos (alert-heading), parágrafos, divisórias (hr), ícones e botões de ação. Para ícones, use Bootstrap Icons (classe bi) ou SVGs com alinhamento flex. d-flex align-items-center centraliza ícone e texto verticalmente. Inclua botões de ação (como 'Estender' para avisos de sessão) junto ao botão de fechar. Alerts não servem só para texto — são containers flexíveis para feedback importante e dispensável.
<!-- alert with icon -->
<div class="alert alert-success d-flex align-items-center" role="alert">
<svg class="bi flex-shrink-0 me-2" width="24" height="24">
<use xlink:href="#check-circle-fill"/>
</svg>
<div>
Operation completed successfully!
</div>
</div>
<!-- alert with more content -->
<div class="alert alert-danger" role="alert">
<h4 class="alert-heading">Error!</h4>
<p>There was a problem processing your request.</p>
<hr>
<p class="mb-0">Please try again or contact support.</p>
</div>
<!-- alert with action button -->
<div class="alert alert-warning alert-dismissible" role="alert">
Your session expires in 5 minutes.
<button type="button" class="btn btn-warning btn-sm ms-3">
Extend
</button>
<button type="button" class="btn-close" data-bs-dismiss="alert"></button>
</div>Notificações toast
Toasts são notificações leves (como os toasts do Android). Ocultam-se automaticamente após um atraso (padrão 5s). Envolva em toast-container para empilhar. position-fixed com top-0 end-0 fixa no canto superior direito. aria-live='assertive' anuncia para leitores de tela. toast-header tem ícone, título, timestamp e botão de fechar; toast-body tem a mensagem. Diferente dos alerts, toasts não bloqueiam a UI — são não intrusivos. Use para 'Salvo!', 'Nova mensagem' ou conclusão de tarefas em segundo plano.
<!-- toast container (top-right by default) -->
<div class="toast-container position-fixed top-0 end-0 p-3">
<div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
<div class="toast-header">
<img src="..." class="rounded me-2" width="20">
<strong class="me-auto">Bootstrap</strong>
<small>11 mins ago</small>
<button type="button" class="btn-close" data-bs-dismiss="toast"></button>
</div>
<div class="toast-body">
Hello, world! This is a toast message.
</div>
</div>
</div>
<script>
// show via JS
const toastEl = document.querySelector('.toast')
const toast = new bootstrap.Toast(toastEl, {
delay: 5000, // auto-hide after 5s
autohide: true
})
toast.show()
// events
toastEl.addEventListener('shown.bs.toast', () => {
console.log('toast visible')
})
</script>Região de alerta ao vivo
Para alerts atualizados dinamicamente (mensagens de status, progresso), use aria-live='polite' — leitores de tela anunciam as mudanças sem interromper. aria-live='assertive' anuncia imediatamente (para erros críticos). aria-atomic='true' lê o conteúdo inteiro ao mudar (não só a parte alterada). role='alert' é implicitamente assertive. Esse padrão de acessibilidade garante que usuários de leitores de tela ouçam as atualizações dinâmicas. Combine com as classes de alert para o estilo visual.
<!-- aria-live for dynamic alerts -->
<div class="alert alert-info" role="alert" aria-live="polite"
aria-atomic="true" id="statusAlert">
<!-- content updated dynamically -->
</div>
<script>
// update alert content
function showStatus(message, type = 'info') {
const alert = document.getElementById('statusAlert')
alert.className = 'alert alert-' + type
alert.textContent = message
}
showStatus('Loading...', 'info')
// later:
showStatus('Data loaded!', 'success')
<!-- aria-live="polite" announces updates without interrupting -->
<!-- aria-live="assertive" interrupts immediately (urgent) -->
<!-- for form errors, use role="alert" (assertive by default) -->
<div role="alert" class="alert alert-danger" id="formError">
Please fix the errors below.
</div>
</script>Badges
Badges básicos
Badges são pequenos indicadores de contagem/rótulo. bg-{color} define o fundo; adicione text-dark em fundos claros (warning, info, light) para contraste. Badges escalam relativamente ao font-size do elemento pai — um badge em h1 é maior que em p. Use badges para: contagens não lidas, rótulos de status, tags 'Novo', números de versão. São elementos inline que cabem no fluxo de texto.
<!-- inline badges -->
<h1>Heading <span class="badge bg-secondary">New</span></h1>
<h2>Heading <span class="badge bg-secondary">New</span></h2>
<h3>Heading <span class="badge bg-secondary">New</span></h3>
<!-- colored badges -->
<span class="badge bg-primary">Primary</span>
<span class="badge bg-secondary">Secondary</span>
<span class="badge bg-success">Success</span>
<span class="badge bg-danger">Danger</span>
<span class="badge bg-warning text-dark">Warning</span>
<span class="badge bg-info text-dark">Info</span>
<span class="badge bg-light text-dark">Light</span>
<span class="badge bg-dark">Dark</span>
<!-- badge sizing scales with parent -->
<h1>Big <span class="badge bg-primary">Badge</span></h1>
<p>Small <span class="badge bg-primary">Badge</span></p>Badges pill e arredondados
rounded-pill torna os badges totalmente arredondados (formato pílula). rounded-0 a rounded-3 controlam a escala de border-radius. rounded-circle com padding cria badges circulares — útil para contagens de notificação. Para círculos perfeitos com um dígito, defina width/height iguais e use d-flex align-items-center justify-content-center. Badges pill são comuns para tags e indicadores de status.
<!-- pill badges (more rounded) -->
<span class="badge rounded-pill bg-primary">Primary</span>
<span class="badge rounded-pill bg-success">Success</span>
<span class="badge rounded-pill bg-danger">Danger</span>
<!-- rounded variations -->
<span class="badge rounded-0 bg-primary">Not rounded</span>
<span class="badge rounded-1 bg-primary">Slightly rounded</span>
<span class="badge rounded-2 bg-primary">Default rounded</span>
<span class="badge rounded-3 bg-primary">More rounded</span>
<span class="badge rounded-pill bg-primary">Full pill</span>
<!-- circle badge (fixed size, centered text) -->
<span class="badge rounded-circle bg-primary p-2">5</span>
<!-- needs width/height for perfect circle -->Badges em botões e nav
Badges em botões: position-relative no botão, position-absolute no badge com top-0 start-100 translate-middle para posicioná-lo no canto superior direito. Texto visually-hidden dentro do badge dá contexto para leitores de tela. Badges em links de nav e itens de lista mostram contagens — use justify-content-between para empurrá-los para a direita. O padrão '99+' é comum quando a contagem passa do limite de exibição.
<!-- badge inside button -->
<button type="button" class="btn btn-primary position-relative">
Inbox
<span class="position-absolute top-0 start-100 translate-middle
badge rounded-pill bg-danger">
99+
</span>
</button>
<!-- badge with position outside button -->
<button class="btn btn-primary position-relative">
Messages
<span class="position-absolute top-0 start-100 translate-middle
badge rounded-pill bg-danger">
9
<span class="visually-hidden">unread messages</span>
</span>
</button>
<!-- badge in nav link -->
<ul class="nav nav-pills">
<li class="nav-item">
<a class="nav-link" href="#">
Profile
<span class="badge bg-secondary">3</span>
</a>
</li>
</ul>
<!-- badge in list item -->
<li class="list-group-item d-flex justify-content-between align-items-center">
Messages
<span class="badge bg-primary rounded-pill">14</span>
</li>Indicadores de badge (ponto)
Badges de ponto (sem texto, só um círculo colorido) indicam status sem contagem — como 'não lido' ou 'online'. Use p-1 com rounded-circle para um ponto pequeno e border-light para separar do fundo. Posicione com a mesma técnica translate-middle. Pontos de status online (verde = online, cinza = offline) ficam no canto inferior dos avatares. Badges também podem envolver ícones (Bootstrap Icons: bi bi-star-fill) com texto para avaliações.
<!-- status dot badge -->
<button class="btn btn-primary position-relative">
Notifications
<span class="position-absolute top-0 start-100 translate-middle
p-1 bg-danger border border-light rounded-circle">
<span class="visually-hidden">New alerts</span>
</span>
</button>
<!-- small dot (no text, just indicator) -->
<span class="position-absolute top-0 start-100 translate-middle
p-1 bg-danger border border-light rounded-circle"></span>
<!-- online status indicator -->
<span class="position-relative d-inline-flex">
<img src="avatar.jpg" class="rounded-circle" width="40">
<span class="position-absolute bottom-0 end-0
bg-success border border-light rounded-circle p-1">
</span>
</span>
<!-- green dot = online -->
<!-- badge with icon -->
<span class="badge bg-primary">
<i class="bi bi-star-fill"></i> 4.5
</span>Spinner border e grow
Spinners indicam estado de carregamento. spinner-border é um anel giratório; spinner-grow é um círculo pulsante. text-* os colore. spinner-border-sm/grow-sm são menores. Tamanhos personalizados via width/height em CSS. Sempre inclua role='status' com texto visually-hidden por acessibilidade. Em botões, use spinner-border-sm com disabled para mostrar uma ação carregando. Spinners são só CSS (sem JS) — animam via borda e transições de opacidade.
<!-- border spinner (rotating border) -->
<div class="spinner-border" role="status">
<span class="visually-hidden">Loading...</span>
</div>
<!-- colored spinner -->
<div class="spinner-border text-primary"></div>
<div class="spinner-border text-success"></div>
<div class="spinner-border text-danger"></div>
<!-- grow spinner (pulsating circle) -->
<div class="spinner-grow" role="status">
<span class="visually-hidden">Loading...</span>
</div>
<!-- sizes -->
<div class="spinner-border spinner-border-sm">Small</div>
<div class="spinner-grow spinner-grow-sm">Small grow</div>
<!-- custom size via CSS -->
<div class="spinner-border" style="width: 3rem; height: 3rem;"></div>
<!-- spinner in button -->
<button class="btn btn-primary" disabled>
<span class="spinner-border spinner-border-sm"></span>
Loading...
</button>
<!-- spinner with text -->
<div class="d-flex align-items-center">
<strong>Loading...</strong>
<div class="spinner-border ms-auto"></div>
</div>Progresso e spinners
Barra de progresso básica
Barras de progresso mostram a conclusão de tarefas. Defina a largura como porcentagem via estilo inline. role='progressbar' com aria-valuenow/min/max serve à acessibilidade. A altura é definida no container .progress (padrão 1rem). bg-{color} na barra muda sua cor. Texto de rótulo dentro da barra é opcional — omita para barras minimalistas. Sempre defina a largura via style (não classe), pois os valores são dinâmicos.
<!-- basic progress bar -->
<div class="progress">
<div class="progress-bar" role="progressbar" style="width: 50%"
aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
50%
</div>
</div>
<!-- without label -->
<div class="progress">
<div class="progress-bar" style="width: 75%" role="progressbar"
aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>
<!-- height (set on container) -->
<div class="progress" style="height: 1px;">
<div class="progress-bar" style="width: 25%"></div>
</div>
<div class="progress" style="height: 20px;">
<div class="progress-bar" style="width: 25%"></div>
</div>
<!-- background -->
<div class="progress">
<div class="progress-bar bg-success" style="width: 25%">25%</div>
</div>Progresso listrado e animado
progress-bar-striped adiciona listras diagonais. progress-bar-animated faz as listras se moverem (para tarefas ativas/em andamento). Use animação só para tarefas em execução no momento — barras estáticas para concluídas. Atualize o progresso via JS mudando style.width e aria-valuenow. A animação usa CSS — não precisa de JS para o movimento. Combine bg-* com striped para barras listradas coloridas.
<!-- striped progress bar -->
<div class="progress">
<div class="progress-bar progress-bar-striped" style="width: 50%">
50%
</div>
</div>
<!-- animated stripes (for in-progress tasks) -->
<div class="progress">
<div class="progress-bar progress-bar-striped progress-bar-animated"
style="width: 75%" role="progressbar">
75%
</div>
</div>
<!-- colored striped -->
<div class="progress">
<div class="progress-bar progress-bar-striped bg-success" style="width: 100%">
Complete
</div>
</div>
<!-- update via JS -->
<div class="progress">
<div class="progress-bar" id="myBar" style="width: 0%"></div>
</div>
<script>
const bar = document.getElementById('myBar')
bar.style.width = '60%' // update progress
bar.setAttribute('aria-valuenow', '60')
</script>Múltiplas barras de progresso
Múltiplas divs progress-bar dentro de um container .progress ficam lado a lado — cada uma ocupa sua porcentagem da largura total. Útil para mostrar composição (por exemplo, armazenamento: 25% fotos, 30% vídeos, 20% apps). As barras compartilham a mesma altura e ficam adjacentes, sem gaps. O total idealmente deve somar 100% (ou menos para incompleto). Cada uma pode ter cor e rótulo próprios.
<!-- stacked bars in one container -->
<div class="progress">
<div class="progress-bar" style="width: 15%">15%</div>
<div class="progress-bar bg-success" style="width: 30%">30%</div>
<div class="progress-bar bg-info" style="width: 20%">20%</div>
</div>
<!-- total: 65% filled, 35% empty -->
<!-- stacked with different colors -->
<div class="progress" style="height: 30px;">
<div class="progress-bar bg-danger" style="width: 25%">Errors</div>
<div class="progress-bar bg-warning" style="width: 25%">Warnings</div>
<div class="progress-bar bg-success" style="width: 50%">Success</div>
</div>
<!-- each bar takes its percentage of the full width -->
<!-- they sit side by side, not overlapping -->Carregamento com esqueleto
Placeholders (carregamento skeleton) mostram blocos cinzas onde o conteúdo vai aparecer — melhor que spinners para páginas com muito conteúdo. placeholder-glow cria um brilho pulsante; placeholder-wave cria uma onda em movimento. col-* define a largura de cada bloco. Para cards skeleton, use placeholder dentro dos componentes card com aria-hidden='true'. Isso dá ao usuário uma prévia do layout antes dos dados carregarem, reduzindo a espera percebida.
<!-- placeholder (gray animated blocks) -->
<div class="placeholder-glow">
<span class="placeholder col-12"></span>
<span class="placeholder col-12"></span>
<span class="placeholder col-8"></span>
</div>
<!-- wave animation -->
<div class="placeholder-wave">
<span class="placeholder col-12"></span>
</div>
<!-- placeholder card (skeleton loading) -->
<div class="card" aria-hidden="true">
<div class="card-body">
<h5 class="card-title placeholder-glow">
<span class="placeholder col-6"></span>
</h5>
<p class="card-text placeholder-glow">
<span class="placeholder col-7"></span>
<span class="placeholder col-4"></span>
<span class="placeholder col-4"></span>
<span class="placeholder col-6"></span>
</p>
<a class="btn btn-primary disabled placeholder col-6"></a>
</div>
</div>Slider de intervalo
form-range estiliza o input range nativo (slider). Defina os atributos min, max e step para o intervalo e o incremento. O slider é de largura total por padrão. Para exibir o valor, use oninput para atualizar um label enquanto o usuário arrasta. Disabled esmaece. Inputs range servem para volume, opacidade ou qualquer valor contínuo em que precisão exata não é necessária. Sempre pareie com um label por acessibilidade.
<!-- range input -->
<label for="customRange1" class="form-label">Example range</label>
<input type="range" class="form-range" id="customRange1" min="0" max="5" step="0.5">
<!-- with value display -->
<div class="d-flex">
<input type="range" class="form-range me-2" id="range"
min="0" max="100" oninput="document.getElementById('val').textContent = this.value">
<span id="val" class="badge bg-primary">50</span>
</div>
<!-- disabled -->
<input type="range" class="form-range" disabled>
<!-- min, max, step -->
<input type="range" class="form-range" min="-10" max="10" step="2" value="0">Classes utilitárias
Espaçamento (margin e padding)
Utilitários de espaçamento seguem {property}{sides}-{size}. m = margin, p = padding. Lados: t/b (top/bottom), s/e (start/end — left/right em LTR), x (esquerda+direita), y (topo+baixo), em branco (cada lado). Tamanhos 0-5 mapeiam a escala de espaçamento (0, 0.25rem, 0.5rem, 1rem, 1.5rem, 3rem). mx-auto centraliza elementos block. Responsivo: adicione o breakpoint (mt-md-3). O Bootstrap 5 renomeou left/right para start/end para suportar RTL.
<!-- format: {property}{sides}-{size} -->
<!-- property: m (margin), p (padding) -->
<!-- sides: t (top), b (bottom), s (start/left), e (end/right), x (both), y (both), blank (all) -->
<!-- size: 0, 1, 2, 3, 4, 5, auto -->
<div class="mt-3">margin-top: 1rem</div>
<div class="mb-4">margin-bottom: 1.5rem</div>
<div class="ms-2">margin-left: 0.5rem (start)</div>
<div class="me-2">margin-right: 0.5rem (end)</div>
<div class="mx-auto">margin: 0 auto (centered)</div>
<div class="my-5">margin top+bottom: 3rem</div>
<div class="p-3">padding: 1rem (all sides)</div>
<div class="px-4">padding left+right: 1.5rem</div>
<div class="pt-2">padding-top: 0.5rem</div>
<!-- responsive: {property}{sides}-{breakpoint}-{size} -->
<div class="mt-0 mt-md-3">No margin on mobile, 1rem on md+</div>
<div class="p-2 p-lg-4">Small padding, larger on lg+</div>Cores e fundos
text-{color} define a cor do texto; bg-{color} define o fundo. text-bg-{color} (Bootstrap 5.2+) define automaticamente a cor de texto contrastante para o fundo. bg-gradient adiciona um gradiente sutil. Opacidade: text-opacity-50 ou bg-opacity-50 (10%, 25%, 50%, 75%, 100%). text-muted é cinza (texto secundário). Sempre garanta contraste suficiente entre texto e fundo — use text-white em fundos escuros. Cores carregam significado semântico (success=verde, danger=vermelho).
<!-- text colors -->
<p class="text-primary">Primary text</p>
<p class="text-success">Success text</p>
<p class="text-danger">Danger text</p>
<p class="text-muted">Muted text</p>
<p class="text-white bg-dark">White on dark</p>
<!-- background colors -->
<div class="bg-primary text-white">Primary bg</div>
<div class="bg-success text-white">Success bg</div>
<div class="bg-light">Light bg</div>
<div class="bg-dark text-white">Dark bg</div>
<!-- gradient background -->
<div class="bg-primary bg-gradient text-white p-3">
Gradient background
</div>
<!-- opacity -->
<div class="text-primary text-opacity-50">50% opacity text</div>
<div class="bg-primary bg-opacity-50">50% opacity bg</div>
<!-- text color with background theme -->
<div class="text-bg-primary">Primary (auto text color)</div>Display e flexbox
d-* define a propriedade display (d-none oculta elementos). Responsivo d-{breakpoint}-* muda o display por breakpoint — d-none d-md-block oculta no mobile, mostra no desktop. d-flex habilita flexbox; flex-direction, justify-content-*, align-items-* e flex-wrap controlam o layout flex. Esses utilitários substituem a maior parte do CSS personalizado de layout. d-md-flex ativa flex só no md+. Combine para layouts responsivos complexos sem media queries.
<!-- display utilities -->
<div class="d-none">display: none</div>
<div class="d-inline">display: inline</div>
<div class="d-inline-block">display: inline-block</div>
<div class="d-block">display: block</div>
<div class="d-flex">display: flex</div>
<div class="d-inline-flex">display: inline-flex</div>
<!-- responsive display -->
<div class="d-none d-md-block">Hidden on mobile, block on md+</div>
<div class="d-block d-md-none">Visible only below md</div>
<!-- flex direction -->
<div class="d-flex flex-column">Column</div>
<div class="d-flex flex-row-reverse">Reversed row</div>
<!-- justify content -->
<div class="d-flex justify-content-center">Center</div>
<div class="d-flex justify-content-between">Space between</div>
<div class="d-flex justify-content-around">Space around</div>
<!-- align items -->
<div class="d-flex align-items-center">Vertically centered</div>
<div class="d-flex align-items-end">Bottom aligned</div>
<!-- flex wrap -->
<div class="d-flex flex-wrap">Wrap</div>
<div class="d-flex flex-nowrap">No wrap</div>Position e floats
position-* define o CSS position. position-sticky com top-0 cria um header fixo ao rolar (gruda quando rola). top/bottom/start/end (0 ou 50%) definem os insets. translate-middle centraliza elementos (combine top-50 start-50 para centralização perfeita). Floats (float-start/end) são legado — use flexbox para layout. clearfix limpa filhos flutuados. fixed-top/fixed-bottom fixam elementos na viewport. Sticky é preferido a fixed para navbars, pois não sobrepõe o conteúdo no início.
<!-- position -->
<div class="position-static">Static (default)</div>
<div class="position-relative">Relative (offset parent)</div>
<div class="position-absolute">Absolute</div>
<div class="position-fixed">Fixed (viewport)</div>
<div class="position-sticky top-0">Sticky (sticks at top)</div>
<!-- positioning with insets -->
<div class="position-absolute top-0 start-0">Top-left</div>
<div class="position-absolute top-0 end-0">Top-right</div>
<div class="position-absolute bottom-0 start-50">Bottom-center</div>
<!-- center with translate -->
<div class="position-absolute top-50 start-50 translate-middle">
Perfectly centered
</div>
<!-- floats (use flexbox instead when possible) -->
<div class="float-start">Float left</div>
<div class="float-end">Float right</div>
<div class="clearfix">Clear floats</div>
<!-- fixed top/bottom -->
<div class="fixed-top">Pinned to top</div>
<div class="fixed-bottom">Pinned to bottom</div>Bordas, sombras e raio
border adiciona/remove bordas em lados específicos. border-{color} as colore; border-{1-5} define a largura. rounded-* controla o border-radius: rounded-0 (nenhum), rounded (padrão), rounded-3 (maior), rounded-pill (cápsula), rounded-circle (50%). rounded-{side} arredonda só cantos específicos. shadow-* adiciona sombras: none, sm, padrão, lg. Sombras dão profundidade — use shadow-sm para elevação sutil, shadow-lg para modals/elementos flutuantes. Esses utilitários cobrem a maior parte da estilização visual sem CSS personalizado.
<!-- borders -->
<div class="border">All borders</div>
<div class="border-top">Top only</div>
<div class="border border-0">No borders</div>
<div class="border-top-0">Remove top</div>
<!-- border color -->
<div class="border border-primary">Primary border</div>
<div class="border border-danger">Danger border</div>
<!-- border width -->
<div class="border border-2">2px border</div>
<div class="border border-4">4px border</div>
<!-- border radius -->
<div class="rounded">Default radius</div>
<div class="rounded-0">No radius</div>
<div class="rounded-3">Larger radius</div>
<div class="rounded-pill">Pill shape</div>
<div class="rounded-circle">Circle</div>
<div class="rounded-top">Top corners only</div>
<!-- shadows -->
<div class="shadow-none">No shadow</div>
<div class="shadow-sm">Small shadow</div>
<div class="shadow">Regular shadow</div>
<div class="shadow-lg">Large shadow</div>Imagens e figures
Imagens responsivas
img-fluid torna imagens responsivas (max-width: 100%, height: auto) — nunca estouram o container. w-100 força largura total. figure/figure-img/figure-caption fornecem imagem com legenda semântica (melhor que div + p). float-start/end alinham imagens; mx-auto d-block centraliza. rounded adiciona cantos arredondados. Sempre inclua texto alt por acessibilidade — descreva a imagem para leitores de tela. Para imagens decorativas, use alt=''.
<!-- responsive image (scales with parent) -->
<img src="photo.jpg" class="img-fluid" alt="Responsive image">
<!-- max-width: 100%; height: auto; -->
<!-- full-width image -->
<img src="banner.jpg" class="img-fluid w-100" alt="Banner">
<!-- image with figure -->
<figure class="figure">
<img src="photo.jpg" class="figure-img img-fluid rounded" alt="...">
<figcaption class="figure-caption text-end">
A caption for the image.
</figcaption>
</figure>
<!-- image alignment -->
<img src="..." class="rounded float-start" alt="Left">
<img src="..." class="rounded float-end" alt="Right">
<img src="..." class="rounded mx-auto d-block" alt="Centered">
<!-- center with text-center on parent -->
<div class="text-center">
<img src="..." class="rounded" alt="Centered">
</div>Formas de imagem e thumbnails
Formas de imagem: rounded (cantos arredondados), rounded-circle (circular — funciona melhor em imagens quadradas), rounded-pill (cápsula). img-thumbnail adiciona borda, padding e cantos arredondados — dá um visual de foto impressa. Combine img-thumbnail com rounded-circle para um thumbnail circular. Para avatares, defina width/height explícitos para reservar espaço e evitar deslocamento de layout. As classes de forma funcionam em qualquer elemento, não só em imagens — úteis para thumbnails de vídeo ou fotos de perfil.
<!-- rounded corners -->
<img src="..." class="rounded" alt="Rounded">
<!-- fully rounded (circle) -->
<img src="..." class="rounded-circle" alt="Circle">
<!-- thumbnail (border + padding) -->
<img src="..." class="img-thumbnail" alt="Thumbnail">
<!-- adds padding, border, rounded corners -->
<!-- pill shape -->
<img src="..." class="rounded-pill" alt="Pill">
<!-- combination: thumbnail + circle -->
<img src="..." class="img-thumbnail rounded-circle" alt="Circle thumb">
<!-- avatar sizes (set width/height) -->
<img src="avatar.jpg" class="rounded-circle" width="40" height="40" alt="Avatar">
<img src="avatar.jpg" class="rounded-circle" width="100" height="100" alt="Large avatar">Figure e legendas
figure é o elemento HTML semântico para imagens com legendas — melhor para acessibilidade que divs. figure-img estiliza a imagem (combine com img-fluid e rounded). figure-caption estiliza o texto da legenda (muted por padrão). text-start/center/end alinham a legenda. Envolva a imagem num <a> para ampliação clicável. Figures são a escolha semântica correta para conteúdo editorial, documentação e galerias.
<!-- figure with caption -->
<figure class="figure">
<img src="photo.jpg" class="figure-img img-fluid rounded" alt="Photo">
<figcaption class="figure-caption">
Caption describing the image.
</figcaption>
</figure>
<!-- right-aligned caption -->
<figure class="figure">
<img src="photo.jpg" class="figure-img img-fluid rounded" alt="Photo">
<figcaption class="figure-caption text-end">
Right-aligned caption.
</figcaption>
</figure>
<!-- centered caption -->
<figcaption class="figure-caption text-center">Centered</figcaption>
<!-- figure with link -->
<figure class="figure">
<a href="full-size.jpg">
<img src="thumb.jpg" class="figure-img img-fluid rounded" alt="Click to enlarge">
</a>
<figcaption class="figure-caption">Click to view full size</figcaption>
</figure>Imagens de fundo
O Bootstrap não tem utilitários background-image (as imagens dependem de conteúdo), então use estilos inline. background-size: cover preenche o container sem distorção; background-position: center foca o centro. Para texto sobre imagens, adicione um overlay de gradiente (escuro na parte inferior) para legibilidade. position-relative num wrapper com camadas position-absolute permite empilhar imagem, overlay e texto. Esse é o padrão para seções hero e cards de imagem.
<!-- background image via inline style -->
<div style="background-image: url('bg.jpg');
background-size: cover;
background-position: center;
height: 400px;">
<div class="d-flex align-items-center justify-content-center h-100">
<h1 class="text-white">Hero text over image</h1>
</div>
</div>
<!-- parallax-like fixed background -->
<div style="background-image: url('bg.jpg');
background-attachment: fixed;
background-size: cover;
height: 300px;">
</div>
<!-- gradient overlay for text readability -->
<div class="position-relative">
<img src="bg.jpg" class="img-fluid" alt="">
<div class="position-absolute top-0 start-0 w-100 h-100"
style="background: linear-gradient(to bottom, transparent, rgba(0,0,0,0.7));">
</div>
<div class="position-absolute bottom-0 start-0 p-4 text-white">
<h2>Text over gradient</h2>
</div>
</div>Grid de imagens e galeria
Grids de imagens usam o sistema padrão row/col com g-* para gutters. Para imagens de mesma altura independentemente da proporção, defina um container de altura fixa e use object-fit: cover no img com w-100 h-100. row-cols-* cria colunas de largura igual sem especificar col-* em cada item. Para masonry verdadeiro (alturas variáveis, sem gaps), são necessárias CSS columns ou bibliotecas JavaScript — o grid do Bootstrap não faz masonry nativamente. img-fluid garante que as imagens nunca estouram suas células do grid.
<!-- responsive image grid -->
<div class="row g-2">
<div class="col-6 col-md-4">
<img src="1.jpg" class="img-fluid rounded" alt="">
</div>
<div class="col-6 col-md-4">
<img src="2.jpg" class="img-fluid rounded" alt="">
</div>
<div class="col-6 col-md-4">
<img src="3.jpg" class="img-fluid rounded" alt="">
</div>
<div class="col-6 col-md-4">
<img src="4.jpg" class="img-fluid rounded" alt="">
</div>
</div>
<!-- equal-height images with object-fit -->
<div class="row g-3">
<div class="col-md-4">
<div style="height: 200px;">
<img src="tall.jpg" class="w-100 h-100"
style="object-fit: cover;" alt="">
</div>
</div>
</div>
<!-- masonry-like with columns -->
<div class="row row-cols-1 row-cols-md-3 g-3">
<div class="col"><img src="1.jpg" class="img-fluid rounded"></div>
<div class="col"><img src="2.jpg" class="img-fluid rounded"></div>
</div>Dropdowns
Dropdown básico
Dropdowns precisam de: um gatilho (botão ou âncora com data-bs-toggle='dropdown') e uma ul.dropdown-menu com elementos dropdown-item. Itens podem ser <a> (para navegação) ou <button> (para ações). aria-expanded reflete o estado aberto. O dropdown é posicionado abaixo do gatilho por padrão (Popper.js cuida do posicionamento). Clicar fora o fecha. O bundle JS (incluindo Popper) é necessário para os dropdowns funcionarem.
<!-- dropdown -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" type="button"
data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else</a></li>
</ul>
</div>
<!-- dropdown with button (not link) items -->
<ul class="dropdown-menu">
<li><button class="dropdown-item" type="button">Action</button></li>
<li><button class="dropdown-item" type="button">Another</button></li>
</ul>
<!-- via anchor tag (for non-button triggers) -->
<a class="btn btn-secondary dropdown-toggle" role="button"
data-bs-toggle="dropdown" aria-expanded="false">
Link dropdown
</a>Conteúdo do menu dropdown
Menus dropdown podem conter: dropdown-header (título de seção), dropdown-divider (linha separadora), dropdown-item (links/botões), dropdown-item-text (texto não clicável), itens active/disabled. Formulários dentro de dropdowns: adicione padding p-4 e use a classe dropdown-menu no próprio form. Ótimo para dropdowns de login ou formulários de filtro. Agrupe itens relacionados com headers e divisórias para menus fáceis de escanear.
<ul class="dropdown-menu">
<!-- header -->
<li><h6 class="dropdown-header">Dropdown header</h6></li>
<!-- items -->
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<!-- divider -->
<li><hr class="dropdown-divider"></li>
<!-- active item -->
<li><a class="dropdown-item active" href="#">Active</a></li>
<!-- disabled item -->
<li><a class="dropdown-item disabled">Disabled</a></li>
<!-- text item -->
<li><span class="dropdown-item-text">Just text</span></li>
</ul>
<!-- dropdown with form -->
<form class="dropdown-menu p-4">
<div class="mb-3">
<label class="form-label">Email</label>
<input type="email" class="form-control" placeholder="[email protected]">
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>Alinhamento do dropdown
dropdown-menu-end alinha o menu à direita. dropdown-menu-{breakpoint}-end alinha à direita só naquele breakpoint. dropup/dropend/dropstart mudam a direção de abertura (use dropup para menus no rodapé da página). data-bs-offset='x,y' desloca a posição do menu. data-bs-auto-close='outside' mantém o menu aberto ao clicar dentro (útil para dropdowns com formulário). Essas opções cobrem a maioria das necessidades de posicionamento sem CSS personalizado.
<!-- default: aligned left below trigger -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Left-aligned
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- right-aligned menu -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Right-aligned
</button>
<ul class="dropdown-menu dropdown-menu-end">...</ul>
</div>
<!-- responsive alignment -->
<ul class="dropdown-menu dropdown-menu-lg-end">
<!-- left on mobile, right on lg+ -->
</ul>
<!-- dropup (menu opens above) -->
<div class="dropup">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Dropup
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- dropend (right) / dropstart (left) -->
<div class="dropend">...</div>
<div class="dropstart">...</div>
<!-- menu offset -->
<button data-bs-toggle="dropdown" data-bs-offset="10,20">
Offset menu
</button>Dropdown via JavaScript
Controle dropdowns via JS: new bootstrap.Dropdown(el) cria uma instância. show()/hide()/toggle() controlam programaticamente. Opções autoClose: true (padrão, fecha em qualquer clique), 'inside' (fecha só ao clicar num item), 'outside' (fecha ao clicar fora), false (nunca fecha automaticamente — fechamento manual). Eventos: show/shown/hide/hidden.bs.dropdown. Use shown.bs.dropdown para carregar conteúdo dinâmico ou focar um item específico. Útil para dropdowns dinâmicos e orientados a dados.
<!-- HTML -->
<div class="dropdown">
<button class="btn btn-secondary" id="dropdownBtn">
Toggle via JS
</button>
<ul class="dropdown-menu" id="myDropdown">
<li><a class="dropdown-item" href="#">Action</a></li>
</ul>
</div>
<script>
const dropdownEl = document.getElementById('myDropdown')
const dropdown = new bootstrap.Dropdown(dropdownEl, {
// options
offset: '10,0',
autoClose: true, // true | 'inside' | 'outside' | false
boundary: 'clippingParents'
})
// methods
dropdown.show()
dropdown.hide()
dropdown.toggle()
// events
dropdownEl.addEventListener('show.bs.dropdown', () => {
console.log('about to show')
})
dropdownEl.addEventListener('shown.bs.dropdown', () => {
console.log('fully shown')
})
dropdownEl.addEventListener('hidden.bs.dropdown', () => {
console.log('fully hidden')
})
</script>Botões dropdown divididos
Botões dropdown divididos separam a ação (botão à esquerda) da alternância do menu (botão de seta pequeno). dropdown-toggle-split reduz o padding do botão de alternância a uma seta estreita. Texto visually-hidden ('Toggle Dropdown') garante acessibilidade para leitores de tela. Os dois botões compartilham a mesma classe de cor. Botões divididos são ideais para 'Salvar' (ação principal) + menu (Salvar como, Exportar etc.). Funcionam com os tamanhos (btn-lg/sm) e direções (dropup, dropend).
<!-- split button dropdown -->
<div class="btn-group">
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-primary dropdown-toggle dropdown-toggle-split"
data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another</a></li>
</ul>
</div>
<!-- split with different sizes -->
<div class="btn-group">
<button class="btn btn-success btn-lg">Large</button>
<button class="btn btn-success btn-lg dropdown-toggle dropdown-toggle-split"
data-bs-toggle="dropdown">
<span class="visually-hidden">Toggle</span>
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- dropup split -->
<div class="btn-group dropup">
<button class="btn btn-secondary">Dropup</button>
<button class="btn btn-secondary dropdown-toggle dropdown-toggle-split"
data-bs-toggle="dropdown">
<span class="visually-hidden">Toggle</span>
</button>
<ul class="dropdown-menu">...</ul>
</div>Collapse e accordion
Collapse básico
Collapse alterna a visibilidade de um elemento com animação de altura. Gatilho: data-bs-toggle='collapse' com data-bs-target (botão) ou href (âncora) apontando para o id do elemento colapsável. .collapse fica oculto; .collapse.show fica visível. aria-expanded no gatilho reflete o estado; aria-controls liga o gatilho ao alvo. Use botões para ações, âncoras para navegação. A animação transiciona a altura de 0 para auto suavemente.
<!-- collapse trigger (button) -->
<p>
<button class="btn btn-primary" type="button"
data-bs-toggle="collapse" data-bs-target="#collapseExample"
aria-expanded="false" aria-controls="collapseExample">
Toggle collapse
</button>
</p>
<div class="collapse" id="collapseExample">
<div class="card card-body">
This content is hidden by default and shown when the button is clicked.
</div>
</div>
<!-- collapse via anchor -->
<a class="btn btn-primary" data-bs-toggle="collapse"
href="#collapseExample2" role="button" aria-expanded="false"
aria-controls="collapseExample2">
Link trigger
</a>
<div class="collapse" id="collapseExample2">
<div class="card card-body">Content</div>
</div>
<!-- shown by default -->
<div class="collapse show" id="alwaysShown">
<div class="card card-body">Shown initially</div>
</div>Accordion
O accordion é um grupo de collapses em que data-bs-parent garante que só um fica aberto por vez (abrir um fecha os outros). Estrutura: accordion > accordion-item > accordion-header (com accordion-button) + accordion-collapse (com accordion-body). O primeiro item pode ter a classe 'show' para começar expandido. A classe 'collapsed' no botão indica o estado colapsado (gira a seta). aria-expanded e aria-controls são essenciais para acessibilidade. O atributo parent cria o comportamento de abertura exclusiva.
<div class="accordion" id="accordionExample">
<div class="accordion-item">
<h2 class="accordion-header" id="headingOne">
<button class="accordion-button" type="button"
data-bs-toggle="collapse" data-bs-target="#collapseOne"
aria-expanded="true" aria-controls="collapseOne">
Accordion Item #1
</button>
</h2>
<div id="collapseOne" class="accordion-collapse collapse show"
aria-labelledby="headingOne" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>First item content.</strong> Shown by default.
</div>
</div>
</div>
<div class="accordion-item">
<h2 class="accordion-header" id="headingTwo">
<button class="accordion-button collapsed" type="button"
data-bs-toggle="collapse" data-bs-target="#collapseTwo"
aria-expanded="false" aria-controls="collapseTwo">
Accordion Item #2
</button>
</h2>
<div id="collapseTwo" class="accordion-collapse collapse"
aria-labelledby="headingTwo" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>Second item content.</strong>
</div>
</div>
</div>
</div>Accordion flush e variantes
accordion-flush remove as bordas externas e o fundo — para integrar em cards ou containers sem bordas duplas. Sem data-bs-parent nos itens de collapse, várias seções podem ficar abertas simultaneamente (modo sempre aberto). Com data-bs-parent, abrir uma fecha as outras (accordion padrão). Escolha pela UX: exclusivo (um aberto) para FAQs em que o usuário lê uma por vez; multi-aberto para navegação ou configurações em que o usuário pode comparar seções.
<!-- flush (no borders, no background) -->
<div class="accordion accordion-flush" id="accordionFlush">
<div class="accordion-item">
<h2 class="accordion-header">
<button class="accordion-button collapsed" data-bs-toggle="collapse"
data-bs-target="#flush1">
Item #1
</button>
</h2>
<div id="flush1" class="accordion-collapse collapse">
<div class="accordion-body">Flush content</div>
</div>
</div>
</div>
<!-- flush removes outer borders and background -->
<!-- always-open (no exclusive behavior) -->
<div class="accordion" id="accordionAlwaysOpen">
<div class="accordion-item">
<h2 class="accordion-header">
<button class="accordion-button" data-bs-toggle="collapse"
data-bs-target="#open1">
Item #1
</button>
</h2>
<div id="open1" class="accordion-collapse collapse show">
<!-- no data-bs-parent = stays open when others open -->
<div class="accordion-body">Content</div>
</div>
</div>
</div>Collapse via JavaScript
Controle o collapse via JS: new bootstrap.Collapse(el, options). toggle: false impede a alternância automática na inicialização. parent: seletor cria comportamento accordion (fecha os irmãos). Funções: show(), hide(), toggle(), dispose(). Eventos: show/shown/hide/hidden.bs.collapse — use shown/hidden (passado) para ações pós-animação, como focar um input ou atualizar o aria. Útil para controle programático, como expandir uma seção com base no hash da URL ou no estado do formulário.
<div class="collapse" id="jsCollapse">
<div class="card card-body">Content</div>
</div>
<script>
const collapseEl = document.getElementById('jsCollapse')
const collapse = new bootstrap.Collapse(collapseEl, {
toggle: false, // don't toggle on init
parent: null // or selector for accordion behavior
})
// methods
collapse.show()
collapse.hide()
collapse.toggle()
// dispose (removes instance)
collapse.dispose()
// events
collapseEl.addEventListener('show.bs.collapse', () => {
console.log('about to show')
})
collapseEl.addEventListener('shown.bs.collapse', () => {
console.log('fully shown')
})
collapseEl.addEventListener('hide.bs.collapse', () => {
console.log('about to hide')
})
collapseEl.addEventListener('hidden.bs.collapse', () => {
console.log('fully hidden')
})
</script>Collapse com múltiplos alvos
data-bs-target aceita seletores CSS, então um gatilho pode alternar vários elementos — use uma classe compartilhada (.multi-collapse) para mirar cada um deles. Inversamente, vários gatilhos podem controlar o mesmo alvo (cada um com data-bs-target='#shared'). Útil para botões 'Mostrar tudo' / 'Ocultar tudo' que controlam várias seções, ou para layouts responsivos em que botões diferentes controlam o mesmo painel de lugares diferentes. A abordagem por seletor é bem flexível.
<!-- one trigger toggles multiple targets -->
<p>
<button class="btn btn-primary" data-bs-toggle="collapse"
data-bs-target=".multi-collapse" aria-expanded="false">
Toggle both
</button>
</p>
<div class="row">
<div class="col">
<div class="collapse multi-collapse" id="first">
<div class="card card-body">First block</div>
</div>
</div>
<div class="col">
<div class="collapse multi-collapse" id="second">
<div class="card card-body">Second block</div>
</div>
</div>
</div>
<!-- multiple triggers control one target -->
<button class="btn btn-primary" data-bs-toggle="collapse"
data-bs-target="#shared">Show A</button>
<button class="btn btn-secondary" data-bs-toggle="collapse"
data-bs-target="#shared">Show B</button>
<div class="collapse" id="shared">
<div class="card card-body">Shared content</div>
</div>Carousel
Carousel básico
Carousels alternam conteúdo (imagens, texto ou personalizado). Estrutura carousel > carousel-inner > carousel-item. O primeiro item precisa da classe 'active'. carousel-control-prev/next com data-bs-slide='prev'/'next' fornecem navegação (data-bs-target deve apontar para o id do carousel). d-block w-100 nas imagens as faz exibir corretamente. data-bs-ride='carousel' habilita a reprodução automática ao carregar. Texto visually-hidden nos controles serve à acessibilidade de leitores de tela.
<div id="carouselExample" class="carousel slide" data-bs-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="slide1.jpg" class="d-block w-100" alt="Slide 1">
</div>
<div class="carousel-item">
<img src="slide2.jpg" class="d-block w-100" alt="Slide 2">
</div>
<div class="carousel-item">
<img src="slide3.jpg" class="d-block w-100" alt="Slide 3">
</div>
</div>
<!-- previous/next controls -->
<button class="carousel-control-prev" type="button"
data-bs-target="#carouselExample" data-bs-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="visually-hidden">Previous</span>
</button>
<button class="carousel-control-next" type="button"
data-bs-target="#carouselExample" data-bs-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="visually-hidden">Next</span>
</button>
</div>Carousel com indicadores
carousel-indicators adiciona pontos clicáveis na parte inferior — um por slide. data-bs-slide-to='0' salta para aquele índice de slide. O indicador ativo recebe classe 'active' e aria-current='true'. Indicadores permitem pular direto a um slide sem ciclar. Sempre inclua indicadores em carousels com mais de 2-3 slides — dão contexto de navegação (em qual slide estou, quantos há no total). Pareie com controles anterior/próximo para navegação completa.
<div id="carouselIndicators" class="carousel slide" data-bs-ride="carousel">
<!-- indicators (dots) -->
<div class="carousel-indicators">
<button type="button" data-bs-target="#carouselIndicators"
data-bs-slide-to="0" class="active" aria-current="true"
aria-label="Slide 1"></button>
<button type="button" data-bs-target="#carouselIndicators"
data-bs-slide-to="1" aria-label="Slide 2"></button>
<button type="button" data-bs-target="#carouselIndicators"
data-bs-slide-to="2" aria-label="Slide 3"></button>
</div>
<div class="carousel-inner">
<div class="carousel-item active">
<img src="1.jpg" class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="2.jpg" class="d-block w-100" alt="...">
</div>
</div>
<!-- controls (same as basic) -->
<button class="carousel-control-prev" data-bs-target="#carouselIndicators"
data-bs-slide="prev">...</button>
<button class="carousel-control-next" data-bs-target="#carouselIndicators"
data-bs-slide="next">...</button>
</div>Carousel com legendas
carousel-caption sobrepõe texto aos slides — ótimo para seções hero. d-none d-md-block oculta legendas no mobile (onde sobreporiam imagens pequenas) e mostra no md+. Legendas podem incluir títulos, parágrafos e botões. Para legibilidade sobre imagens, adicione um overlay de gradiente sob a legenda (parecido com o padrão de overlay de imagem). Legendas de carousel são a forma padrão de transformar carousels de imagem em seções hero de marketing com CTAs.
<div id="carouselCaptions" class="carousel slide" data-bs-ride="carousel">
<div class="carousel-indicators">
<button data-bs-target="#carouselCaptions" data-bs-slide-to="0"
class="active" aria-current="true"></button>
<button data-bs-target="#carouselCaptions" data-bs-slide-to="1"></button>
</div>
<div class="carousel-inner">
<div class="carousel-item active">
<img src="hero1.jpg" class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>First slide label</h5>
<p>Some representative placeholder content.</p>
<a href="#" class="btn btn-primary">Learn more</a>
</div>
</div>
<div class="carousel-item">
<img src="hero2.jpg" class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>Second slide label</h5>
<p>Content for second slide.</p>
</div>
</div>
</div>
</div>Opções do carousel e crossfade
carousel-fade substitui a transição de slide por crossfade. carousel-dark usa controles/indicadores escuros (para imagens claras). Opções: interval (ms entre slides automáticos), pause ('hover' pausa ao passar o mouse), wrap (loop), touch (suporte a swipe). Funções JS: cycle(), pause(), next(), prev(), to(n). Eventos: slide.bs.carousel (disparando) e slid.bs.carousel (concluído) fornecem os índices from/to para animações personalizadas ou analytics.
<!-- crossfade transition -->
<div id="carouselFade" class="carousel slide carousel-fade" data-bs-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="1.jpg" class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="2.jpg" class="d-block w-100" alt="...">
</div>
</div>
</div>
<!-- dark variant (for light images) -->
<div class="carousel carousel-dark slide" data-bs-ride="carousel">
<!-- controls and indicators are dark -->
</div>
<!-- via JavaScript with options -->
<script>
const carousel = new bootstrap.Carousel(document.getElementById('myCarousel'), {
interval: 5000, // auto-play every 5s
keyboard: true, // arrow keys navigate
pause: 'hover', // pause on mouse hover
ride: 'carousel', // auto-start
wrap: true, // loop back to first slide
touch: true // swipe on touch devices
})
carousel.cycle() // start auto-play
carousel.pause() // pause
carousel.next() // next slide
carousel.prev() // previous slide
carousel.to(2) // jump to slide 2
</script>Carousel touch e responsivo
O swipe por toque é habilitado por padrão (data-bs-touch='true'). Para carousels responsivos com imagens diferentes por breakpoint, empilhe dois imgs com d-block d-md-none (mobile) e d-none d-md-block (desktop) no mesmo carousel-item — só um aparece por vez. data-bs-ride='false' desabilita a reprodução automática (navegação manual). data-bs-pause='hover' pausa ao passar o mouse — considere para conteúdo que o usuário precisa ler. Sempre teste carousels em dispositivos touch quanto ao comportamento de swipe.
<!-- touch swipe enabled (default) -->
<div id="carouselTouch" class="carousel slide" data-bs-ride="carousel"
data-bs-touch="true" data-bs-interval="5000">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="1.jpg" class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="2.jpg" class="d-block w-100" alt="...">
</div>
</div>
</div>
<!-- different image sizes per breakpoint -->
<div class="carousel slide" data-bs-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<!-- mobile image -->
<img src="mobile.jpg"
class="d-block w-100 d-md-none" alt="...">
<!-- desktop image -->
<img src="desktop.jpg"
class="d-none d-md-block w-100" alt="...">
</div>
</div>
</div>
<!-- disable auto-play -->
<div class="carousel slide" data-bs-ride="false">
<!-- only moves via controls -->
</div>
<!-- pause on hover -->
<div class="carousel slide" data-bs-ride="carousel" data-bs-pause="hover">
<!-- pauses when mouse is over -->
</div>Ícones e acessibilidade
Bootstrap Icons
Bootstrap Icons é uma biblioteca de ícones separada (não incluída no CSS). Inclua o CSS e use <i class='bi bi-{name}'></i>. Dimensione os ícones com utilitários fs-* (font-size). Colore-os com classes text-*. Ícones em botões melhoram a UX com pistas visuais. Botões só de ícone PRECISAM de aria-label para leitores de tela — sem ele, o botão não tem nome acessível. Navegue pelos ícones em icons.getbootstrap.com. Ícones são fontes SVG, então escalam nítidos em qualquer tamanho.
<!-- Bootstrap Icons (separate from CSS framework) -->
<link rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/[email protected]/font/bootstrap-icons.css">
<!-- usage: <i class="bi bi-{name}"></i> -->
<i class="bi bi-alarm"></i>
<i class="bi bi-arrow-right"></i>
<i class="bi bi-check-circle"></i>
<i class="bi bi-github"></i>
<!-- sizing with utility classes -->
<i class="bi bi-star fs-1"></i> <!-- font-size 1 -->
<i class="bi bi-star fs-3"></i>
<i class="bi bi-star fs-6"></i>
<!-- colored icons -->
<i class="bi bi-exclamation-triangle text-warning fs-3"></i>
<i class="bi bi-check-circle text-success fs-3"></i>
<!-- icon in a button -->
<button class="btn btn-primary">
<i class="bi bi-download"></i> Download
</button>
<!-- icon-only button (needs aria-label) -->
<button class="btn btn-link" aria-label="Search">
<i class="bi bi-search"></i>
</button>Acessibilidade: ARIA e roles
Os componentes do Bootstrap incluem atributos ARIA, mas você precisa adicioná-los para controles personalizados. aria-label fornece nomes para botões só de ícone. aria-labelledby referencia o id de outro elemento como rótulo. aria-describedby aponta para texto de ajuda. aria-expanded reflete o estado de alternância (true/false). aria-current='page' marca o item de navegação atual. Use HTML semântico (nav, main, aside, header, footer), que tem roles ARIA implícitos — melhor que adicionar atributos role a divs.
<!-- landmark roles (use semantic HTML) -->
<nav role="navigation">...</nav>
<main role="main">...</main>
<aside role="complementary">...</aside>
<footer role="contentinfo">...</footer>
<!-- aria-label for unlabeled controls -->
<button aria-label="Close" class="btn-close"></button>
<button aria-label="Search" class="btn"><i class="bi bi-search"></i></button>
<!-- aria-labelledby (reference another element) -->
<div role="dialog" aria-labelledby="modalTitle">
<h2 id="modalTitle">Modal Heading</h2>
</div>
<!-- aria-describedby (descriptive text) -->
<input aria-describedby="emailHelp" id="email">
<small id="emailHelp">We'll never share your email.</small>
<!-- aria-expanded for toggles -->
<button aria-expanded="false" data-bs-toggle="collapse">
Toggle
</button>
<!-- aria-current for current page -->
<a aria-current="page" class="nav-link active">Home</a>Visually hidden e leitor de tela
visually-hidden oculta o conteúdo visualmente mas o mantém para leitores de tela — use para labels em botões só de ícone ou contexto extra. visually-hidden-focusable fica oculto até receber foco do teclado (perfeito para links 'Pular para o conteúdo principal' que aparecem ao Tab). aria-hidden='true' faz o oposto: visível mas não anunciado (para elementos decorativos). Sempre forneça um skip link como primeiro elemento focável para acessibilidade de teclado. Essencial para conformidade WCAG.
<!-- visually hidden (hidden visually, read by screen readers) -->
<span class="visually-hidden">This text is read by screen readers</span>
<!-- for icon-only buttons -->
<button class="btn btn-primary" aria-label="Search">
<i class="bi bi-search"></i>
<span class="visually-hidden">Search</span>
</button>
<!-- skip link (keyboard users skip to content) -->
<a href="#main-content" class="visually-hidden-focusable">
Skip to main content
</a>
<!-- visually-hidden-focusable: hidden until focused -->
<!-- useful for skip links that appear on Tab -->
<!-- main content target -->
<main id="main-content">
<!-- skip link jumps here -->
</main>
<!-- hide from screen readers only (still visible) -->
<div aria-hidden="true">
Decorative content (not announced)
</div>Movimento reduzido e modo escuro
Modo escuro: defina data-bs-theme='dark' no <html> — o Bootstrap troca as variáveis CSS. Alterne via JS mudando o atributo. Respeite a preferência do sistema com matchMedia('(prefers-color-scheme: dark)'). Para movimento reduzido, o Bootstrap desabilita automaticamente a maioria das animações quando o usuário tem prefers-reduced-motion: reduce definido. Você pode adicionar mais regras para reduzir ainda mais. Guarde a preferência de tema do usuário no localStorage. Esses recursos tornam seu site acessível e confortável para qualquer pessoa.
<!-- dark mode via data attribute -->
<html data-bs-theme="dark">
<!-- entire page in dark mode -->
</html>
<!-- toggle dark mode via JS -->
<button id="themeToggle">Toggle theme</button>
<script>
const html = document.documentElement
const current = html.getAttribute('data-bs-theme')
html.setAttribute('data-bs-theme', current === 'dark' ? 'light' : 'dark')
</script>
<!-- respect system preference -->
<script>
if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
document.documentElement.setAttribute('data-bs-theme', 'dark')
}
</script>
<!-- reduced motion: Bootstrap respects this automatically -->
@media (prefers-reduced-motion: reduce) {
/* Bootstrap disables transitions and animations */
/* but you can add more */
.carousel {
transition: none;
}
}Gerenciamento de foco e teclado
Nunca remova os contornos de foco (outline: none) sem fornecer alternativa — usuários de teclado precisam deles. O focus-visible do Bootstrap mostra o anel só para foco de teclado, não de mouse. Em modals, mova o foco para dentro do modal ao abrir e devolva ao gatilho ao fechar. Widgets personalizados (tabs, menus) precisam de navegação por setas — implemente handlers keydown para as setas, Enter, Space e Escape. Gerenciamento adequado de tabindex (0 para focável, -1 para focável programaticamente) garante ordem de tab lógica. Essencial para usuários só de teclado.
<!-- visible focus (don't remove outlines!) -->
<!-- Bootstrap provides focus-visible styling -->
<button class="btn btn-primary">Has visible focus ring</button>
<!-- skip link (first focusable element) -->
<body>
<a href="#main" class="visually-hidden-focusable">Skip to content</a>
<nav>...</nav>
<main id="main">...</main>
</body>
<!-- focus management for modals -->
<script>
const modal = document.getElementById('myModal')
modal.addEventListener('shown.bs.modal', () => {
// focus first input in modal
modal.querySelector('input')?.focus()
})
modal.addEventListener('hidden.bs.modal', () => {
// return focus to trigger
document.getElementById('openModalBtn').focus()
})
</script>
<!-- keyboard navigation for custom widgets -->
<div role="tablist">
<button role="tab" tabindex="0">Tab 1</button>
<button role="tab" tabindex="-1">Tab 2</button>
</div>
<script>
// arrow key navigation
document.querySelectorAll('[role="tab"]').forEach((tab, i, tabs) => {
tab.addEventListener('keydown', (e) => {
if (e.key === 'ArrowRight') tabs[(i + 1) % tabs.length].focus()
if (e.key === 'ArrowLeft') tabs[(i - 1 + tabs.length) % tabs.length].focus()
})
})
</script>List group
List group básico
list-group é um componente flexível para exibir uma série de conteúdos. list-group-item estiliza cada entrada. active marca o item atual; disabled o esmaece (use aria-disabled='true' por acessibilidade). List groups são mais semânticos que divs estilizadas para listas de conteúdo relacionado como dashboards, configurações ou caixas de entrada. Use <ul>/<li> para listas de navegação, ou <div> para conteúdo que não é lista.
<!-- basic list group -->
<ul class="list-group">
<li class="list-group-item">An item</li>
<li class="list-group-item">A second item</li>
<li class="list-group-item">A third item</li>
<li class="list-group-item">A fourth item</li>
<li class="list-group-item">A disabled item</li>
</ul>
<!-- with active item -->
<ul class="list-group">
<li class="list-group-item active" aria-current="true">Active item</li>
<li class="list-group-item">Regular item</li>
</ul>
<!-- disabled item -->
<ul class="list-group">
<li class="list-group-item disabled" aria-disabled="true">Disabled</li>
</ul>List group com links e botões
Para itens de lista acionáveis (clicáveis), use list-group-item-action em elementos <a> ou <button>. Isso adiciona estados de hover e focus. Use <a> para navegação (com href) e <button type='button'> para ações. Desabilite links com a classe .disabled (e aria-disabled); desabilite botões com o atributo disabled. Evite <li> para itens acionáveis — use <div> como wrapper do list-group, já que <a>/<button> dentro de <ul> é menos semântico.
<!-- list group with links (actionable items) -->
<div class="list-group">
<a href="#" class="list-group-item list-group-item-action active"
aria-current="true">
Active link item
</a>
<a href="#" class="list-group-item list-group-item-action">Link item</a>
<a href="#" class="list-group-item list-group-item-action">Another link</a>
<a class="list-group-item list-group-item-action disabled">Disabled link</a>
</div>
<!-- with buttons instead of links -->
<div class="list-group">
<button type="button" class="list-group-item list-group-item-action active">
Button item
</button>
<button type="button" class="list-group-item list-group-item-action">
Another button
</button>
</div>
<!-- note: use list-group-item-action for hover/focus states -->List group flush e numerado
list-group-flush remove bordas e cantos arredondados — para embutir em cards ou containers sem bordas duplas. list-group-numbered (em <ol>) adiciona numeração automática via CSS counters. list-group-horizontal faz os itens ficarem lado a lado; variantes responsivas (list-group-horizontal-md) mudam para horizontal num breakpoint. Listas horizontais são úteis para navegação pequena ou barras de filtro. Listas numeradas são ótimas para instruções passo a passo ou rankings.
<!-- flush (no borders, no background, edge-to-edge) -->
<ul class="list-group list-group-flush">
<li class="list-group-item">Flush item 1</li>
<li class="list-group-item">Flush item 2</li>
<li class="list-group-item">Flush item 3</li>
</ul>
<!-- removes outer borders and rounded corners -->
<!-- numbered list group (ordered) -->
<ol class="list-group list-group-numbered">
<li class="list-group-item">First item</li>
<li class="list-group-item">Second item</li>
<li class="list-group-item">Third item</li>
</ol>
<!-- CSS counters add the numbers automatically -->
<!-- horizontal list group -->
<ul class="list-group list-group-horizontal">
<li class="list-group-item">Item 1</li>
<li class="list-group-item">Item 2</li>
<li class="list-group-item">Item 3</li>
</ul>
<!-- responsive horizontal -->
<ul class="list-group list-group-horizontal-md">
<!-- horizontal at md+, vertical below -->
</ul>Cores contextuais e badges do list group
Classes contextuais (list-group-item-{color}) tingem itens para indicação de status — use com significado (success=concluído, danger=erro). Para badges dentro dos itens de lista, use d-flex justify-content-between align-items-center para empurrar o badge para a direita e centralizá-lo verticalmente. Badges rounded-pill parecem modernos para contagens. Esse padrão é a clássica lista de inbox/notificações: rótulo à esquerda, contagem à direita. Os utilitários flex cuidam do alinhamento sem CSS personalizado.
<!-- contextual color items -->
<ul class="list-group">
<li class="list-group-item list-group-item-primary">Primary item</li>
<li class="list-group-item list-group-item-secondary">Secondary</li>
<li class="list-group-item list-group-item-success">Success</li>
<li class="list-group-item list-group-item-danger">Danger</li>
<li class="list-group-item list-group-item-warning">Warning</li>
<li class="list-group-item list-group-item-info">Info</li>
<li class="list-group-item list-group-item-light">Light</li>
<li class="list-group-item list-group-item-dark">Dark</li>
</ul>
<!-- with badges (counts aligned right) -->
<ul class="list-group">
<li class="list-group-item d-flex justify-content-between align-items-center">
Messages
<span class="badge bg-primary rounded-pill">14</span>
</li>
<li class="list-group-item d-flex justify-content-between align-items-center">
Notifications
<span class="badge bg-danger rounded-pill">3</span>
</li>
<li class="list-group-item d-flex justify-content-between align-items-center">
Spam
<span class="badge bg-warning text-dark rounded-pill">1</span>
</li>
</ul>Conteúdo personalizado do list group
Itens de lista podem conter conteúdo rico: títulos (fw-bold), descrições (text-muted), metadados (small) e badges. Use d-flex justify-content-between align-items-start para dispor conteúdo e badge. me-auto empurra o badge para a direita. Para checkboxes/radios nos itens, use form-check-input com um form-check-label correspondente — isso cria listas selecionáveis. Casos de uso comuns: listas de e-mail, painéis de configuração e resultados de busca em que cada item tem título, descrição e status.
<!-- rich content list item -->
<ul class="list-group">
<li class="list-group-item d-flex justify-content-between align-items-start">
<div class="ms-2 me-auto">
<div class="fw-bold">Subheading</div>
<p class="mb-0 text-muted">Descriptive text for the list item.</p>
<small>Additional metadata</small>
</div>
<span class="badge bg-primary rounded-pill">New</span>
</li>
<li class="list-group-item d-flex justify-content-between align-items-start">
<div class="ms-2 me-auto">
<div class="fw-bold">Another item</div>
<p class="mb-0">More content here.</p>
</div>
<span class="badge bg-secondary rounded-pill">3</span>
</li>
</ul>
<!-- list group with checkbox/radio -->
<ul class="list-group">
<li class="list-group-item">
<input class="form-check-input me-1" type="checkbox" id="check1">
<label class="form-check-label" for="check1">Checkbox item</label>
</li>
<li class="list-group-item">
<input class="form-check-input me-1" type="radio" name="radio" id="radio1">
<label class="form-check-label" for="radio1">Radio item</label>
</li>
</ul>Snippets de Bootstrap relacionados
Copy-paste ready code for common tasks.
Grid System
Lay out pages with the 12-column responsive grid.
Responsive Utilities
Show, hide, and reorder elements per breakpoint.
Navbar
Build a responsive collapsing navbar with brand and links.
Cards
Compose a card with image, body, list, and footer.
Modal
Trigger and structure a Bootstrap modal dialog.
Forms & Validation
Build a responsive form with validation feedback.
Buttons
Use button variants, sizes, states, and groups.
Alerts
Display contextual messages with dismissible alerts.
Was this helpful?