Skip to content

Bootstrap Folha de referência

Kit de ferramentas front-end poderoso, extensível e cheio de recursos, construído com CSS e JavaScript.

01

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.

bootstrap
<!-- 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 JS

Containers

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.

bootstrap
<!-- 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
/* 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.

bootstrap
<!-- 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.

bootstrap
: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>
02

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.

bootstrap
<!-- .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.

bootstrap
<!-- 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-*.

bootstrap
<!-- 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.

bootstrap
<!-- 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
/* 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>
03

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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 -->
04

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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 (&lt; para <). Blockquotes podem ser alinhados com text-center/text-end. O estilo do kbd dá às teclas uma aparência de teclado.

bootstrap
<!-- 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>&lt;section&gt;</code> tag.</p>

<!-- code block -->
<pre><code>&lt;div class="container"&gt;
  Hello
&lt;/div&gt;
</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.

bootstrap
<!-- 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>
05

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
06

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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 -->
07

Botões

Variantes de botão

btn é a classe base de botão; btn-{color} define a variante. Botões sólidos têm fundo colorido com texto branco. Botões outline (btn-outline-*) têm fundo transparente com texto/bordas coloridos — bons para ações secundárias. btn-link faz um botão parecer um link. Escolha cores com significado: success para confirmar, danger para excluir, warning para atenção. Não use cor sozinha para transmitir significado — inclua texto.

bootstrap
<!-- solid buttons -->
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-secondary">Secondary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-light">Light</button>
<button type="button" class="btn btn-dark">Dark</button>

<!-- link-styled button -->
<button type="button" class="btn btn-link">Link</button>

<!-- outline buttons (transparent bg, colored border) -->
<button type="button" class="btn btn-outline-primary">Outline Primary</button>
<button type="button" class="btn btn-outline-danger">Outline Danger</button>

Tamanhos e estados de botão

Tamanhos de botão: btn-lg, padrão, btn-sm. O atributo disabled (em <button>) ou a classe .disabled (em <a> ou quando não pode usar o atributo) esmaece o botão. .active adiciona aparência pressionada. Para botões de largura total, use d-grid gap-2 (faz os botões empilhar e preencher a largura). d-md-block volta ao inline no breakpoint md — útil para largura total no mobile e automático no desktop. A classe .disabled também define pointer-events: none.

bootstrap
<!-- sizes -->
<button class="btn btn-primary btn-lg">Large</button>
<button class="btn btn-primary">Default</button>
<button class="btn btn-primary btn-sm">Small</button>

<!-- disabled state -->
<button class="btn btn-primary" disabled>Disabled</button>
<!-- or -->
<button class="btn btn-primary disabled">Disabled (aria)</button>

<!-- active/pressed state -->
<button class="btn btn-primary active" aria-pressed="true">Active</button>

<!-- full-width block button -->
<div class="d-grid gap-2">
  <button class="btn btn-primary">Block button</button>
  <button class="btn btn-secondary">Another</button>
</div>

<!-- responsive block buttons -->
<div class="d-grid gap-2 d-md-block">
  <button class="btn btn-primary">Full on mobile, auto on md+</button>
</div>

Grupos de botões

btn-group agrupa botões horizontalmente com bordas conectadas. btn-toolbar combina vários grupos com espaçamento. btn-group-vertical empilha botões verticalmente. Sempre adicione role='group' e aria-label por acessibilidade. Classes de tamanho (btn-group-lg/sm) aplicam aos botões do grupo. Grupos de botões são a base para toolbars, controles segmentados e UIs parecidas com paginação.

bootstrap
<!-- basic button group -->
<div class="btn-group" role="group" aria-label="Basic example">
  <button type="button" class="btn btn-outline-primary">Left</button>
  <button type="button" class="btn btn-outline-primary">Middle</button>
  <button type="button" class="btn btn-outline-primary">Right</button>
</div>

<!-- button toolbar (groups of groups) -->
<div class="btn-toolbar" role="toolbar" aria-label="Toolbar">
  <div class="btn-group me-2" role="group">
    <button class="btn btn-outline-secondary">1</button>
    <button class="btn btn-outline-secondary">2</button>
  </div>
  <div class="btn-group" role="group">
    <button class="btn btn-outline-secondary">3</button>
    <button class="btn btn-outline-secondary">4</button>
  </div>
</div>

<!-- vertical button group -->
<div class="btn-group-vertical" role="group">
  <button class="btn btn-outline-primary">Top</button>
  <button class="btn btn-outline-primary">Middle</button>
  <button class="btn btn-outline-primary">Bottom</button>
</div>

<!-- sizing -->
<div class="btn-group btn-group-lg">...</div>
<div class="btn-group btn-group-sm">...</div>

Botões de alternância e checkbox

btn-check é um checkbox/radio oculto que se pareia com um label btn para comportamento de alternância. O input fica visualmente oculto; o label (estilizado como botão) mostra o estado. Para alternância única, use um checkbox. Para opções mutuamente exclusivas, use radios com o mesmo name. A aparência do botão muda quando marcado. autocomplete='off' evita que o navegador restaure o estado. Essa é a forma acessível de criar toggles com aparência de botão.

bootstrap
<!-- toggle button (single) -->
<input type="checkbox" class="btn-check" id="btn-check" autocomplete="off">
<label class="btn btn-primary" for="btn-check">Toggle</label>

<!-- checked by default -->
<input type="checkbox" class="btn-check" id="btn-check-checked" checked autocomplete="off">
<label class="btn btn-primary" for="btn-check-checked">Checked</label>

<!-- radio button group -->
<div class="btn-group" role="group" aria-label="Radio toggle">
  <input type="radio" class="btn-check" name="options" id="opt1" autocomplete="off" checked>
  <label class="btn btn-outline-primary" for="opt1">Option 1</label>
  <input type="radio" class="btn-check" name="options" id="opt2" autocomplete="off">
  <label class="btn btn-outline-primary" for="opt2">Option 2</label>
</div>

<!-- outline toggle (changes when checked) -->
<input type="checkbox" class="btn-check" id="btn-check-out" autocomplete="off">
<label class="btn btn-outline-success" for="btn-check-out">Toggle</label>

Botões com dropdown

Dropdowns precisam de data-bs-toggle='dropdown' no botão de alternância. O menu é uma ul.dropdown-menu com links dropdown-item. dropdown-divider separa grupos. Botões divididos (dropdown-toggle-split) têm um botão de ação separado e uma seta de alternância — adicione texto visually-hidden por acessibilidade. dropdown-item.active marca a seleção atual; .disabled a esmaece. Dropdowns exigem o bundle JS do Bootstrap (inclui o Popper para posicionamento).

bootstrap
<!-- button dropdown -->
<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button"
          data-bs-toggle="dropdown" aria-expanded="false">
    Dropdown button
  </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><hr class="dropdown-divider"></li>
    <li><a class="dropdown-item" href="#">Separated link</a></li>
  </ul>
</div>

<!-- split 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">...</ul>
</div>

<!-- dropdown with active/disabled items -->
<li><a class="dropdown-item active" href="#">Active</a></li>
<li><a class="dropdown-item disabled">Disabled</a></li>
08

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.

bootstrap
<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.

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
11

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
12

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
13

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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">
14

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.

bootstrap
<!-- 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).

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
15

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=''.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
17

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.

bootstrap
<!-- 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.

bootstrap
<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.

bootstrap
<!-- 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.

bootstrap
<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.

bootstrap
<!-- 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>
19

Í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
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>
20

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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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.

bootstrap
<!-- 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>

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.