Skip to content

Bootstrap Hoja de referencia

Kit de herramientas frontend potente, extensible y repleto de funcionalidades, construido sobre CSS y JavaScript.

01

Primeros pasos

Incluir Bootstrap

Incluye Bootstrap vía CDN para empezar rápido — el CSS va en el <head> y el bundle de JS (que incluye Popper) va antes de </body>. El bundle.min.js incluye Popper para tooltips/dropdowns/popovers. Con npm, importa el CSS y el JS en tu archivo de entrada. Bootstrap 5 eliminó la dependencia de jQuery — cada componente funciona con JS vanilla.

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

Contenedores

Los containers son el elemento de layout más básico — centran el contenido y añaden padding horizontal. .container tiene ancho fijo en cada breakpoint (cambia el max-width); .container-fluid siempre ocupa el 100%. Los containers responsivos (container-sm/md/lg/xl/xxl) ocupan el 100% hasta el breakpoint indicado y luego pasan a ancho fijo. Usa .container para la mayoría de los layouts; .container-fluid para apps a ancho completo.

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

Bootstrap usa un sistema de media queries mobile-first de min-width. Hay 6 breakpoints: xs (por defecto), sm (576px), md (768px), lg (992px), xl (1200px), xxl (1400px). Clases como col-md-6 se aplican en md Y superiores. Para mostrar/ocultar en breakpoints, usa d-none (display:none) y d-{breakpoint}-block. Este enfoque mobile-first significa que estilizas primero para pantallas pequeñas y luego añades complejidad para las más grandes.

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 y estilos base

Reboot es el reset de CSS de Bootstrap — normaliza los estilos del navegador usando unidades rem (root em, basadas en el font-size de 16px del html). Cada elemento recibe box-sizing: border-box. Encabezados, párrafos, listas, tablas y enlaces obtienen valores por defecto sensatos. Reboot elimina los márgenes superiores de encabezados y listas, poniéndolos a 0. Esto da una base consistente entre navegadores antes de que los componentes de Bootstrap se superpongan.

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>

Personalización con variables CSS

Bootstrap 5 expone cientos de propiedades personalizadas de CSS (variables) con el prefijo --bs-. Sobrescríbelas en :root para tematizar tu sitio globalmente. El modo oscuro viene integrado mediante data-bs-theme='dark' en el elemento <html>, que intercambia un conjunto de variables. Esto hace la tematización mucho más fácil que el antiguo enfoque de variables Sass — puedes cambiar colores, fuentes, espaciados y radios con CSS puro, sin paso 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

Fundamentos de layout

Filas y columnas

.row es un contenedor flex (display: flex) con márgenes horizontales negativos para compensar el padding de las columnas. Los hijos .col directos se reparten equitativamente para llenar la fila. Especifica col-{1-12} para proporciones fijas (de 12). Sin número, .col toma el espacio restante por igual. La cuadrícula de 12 columnas es el núcleo de los layouts de Bootstrap — combina col-{n} y .col automáticos para layouts flexibles.

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 (espacio entre columnas)

Los gutters son el padding entre columnas, controlados por las clases g-* (de g-0 a g-5). g-0 elimina por completo los gutters (columnas de borde a borde). g-3 es el valor por defecto. Los gutters funcionan tanto horizontal (entre columnas) como verticalmente (entre filas cuando las columnas se envuelven). Usa variantes responsivas (g-2 g-md-4) para espaciados distintos por breakpoint. El sistema de gutters reemplazó al antiguo enfoque de padding solo 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>

Envoltura y alineación de columnas

Las columnas pasan a una nueva línea cuando su total supera 12. Controla la alineación vertical con align-items-* en la fila (start/center/end). Controla la distribución horizontal con justify-content-* (start/center/end/between/around/evenly). Por debajo usan flexbox. La envoltura es automática — no hacen falta saltos de fila explícitos. Esto hace que los layouts tipo masonry sean fáciles con solo clases 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 -->

Ordenación de columnas

Las clases order reordenan las columnas visualmente sin cambiar el HTML. order-first, order-{1-5} y order-last ofrecen 7 niveles. Usa variantes responsivas (order-md-first) para cambiar el orden en ciertos breakpoints — útil para SEO (contenido importante primero en el HTML) mostrándolo distinto en móvil. Los offsets (offset-md-4) añaden margen izquierdo para empujar columnas a la derecha — útil para centrar o indentar. Ambos se apoyan en el order de flexbox y las utilidades de margen.

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 y apilamiento

Bootstrap usa una escala de z-index para el apilamiento: z-1, z-2, z-3 (y negativos z-n0, z-n1, z-n2). Componentes como modals, dropdowns y tooltips tienen valores de z-index integrados más altos (1000-1080). Para que el z-index funcione, el elemento necesita position (relative, absolute, fixed o sticky). Evita valores de z-index arbitrarios — usa la escala de Bootstrap por consistencia. El orden de apilamiento está diseñado para que los modals aparezcan siempre sobre los dropdowns, que a su vez aparecen sobre las 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 cuadrícula

Cuadrícula básica

La cuadrícula de Bootstrap es un sistema de 12 columnas. col-{1-12} indica cuántas de las 12 columnas abarca un elemento. col-12 = ancho completo, col-6 = la mitad, col-4 = un tercio, col-3 = un cuarto. Las columnas de una fila deberían sumar 12 (o menos — el espacio restante se reparte). Sin número, .col divide el espacio restante por igual. La cuadrícula usa flexbox — las filas son contenedores flex y las columnas son ítems flex.

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>

Columnas responsivas

Las clases de columna responsivas (col-sm-*, col-md-*, col-lg-*, col-xl-*, col-xxl-*) se aplican en ese breakpoint Y superiores (mobile-first). Gana la clase aplicable más pequeña. col-12 col-md-6 col-lg-4 significa: ancho completo en móvil, la mitad en tablets, un tercio en escritorio. row-cols-* fija el número de columnas de igual ancho por fila en un breakpoint — más simple que especificar col-* en cada hijo cuando todas las columnas son iguales.

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>

Anidar columnas

Para anidar cuadrículas, pon un .row dentro de un .col — la fila anidada crea un nuevo contexto de 12 columnas dentro del ancho de la columna padre. Las columnas anidadas (col-4, col-8) dividen el ancho del padre, no el de toda la página. Anidar es esencial para layouts complejos como sidebars con subsecciones. Mantén el anidamiento poco profundo (2-3 niveles como máximo) para evitar columnas demasiado estrechas y conservar la legibilidad.

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 y márgenes de columnas

offset-{breakpoint}-{n} añade n columnas de margen izquierdo, útil para centrar o indentar. offset-md-4 sobre un col-md-4 lo centra (4 + 4 + 4 = 12). Para un centrado más simple, usa mx-auto (margin: 0 auto), que funciona sin importar el número de columnas. Los offsets responsivos (offset-sm-2 offset-md-0) permiten indentar en móvil pero no en escritorio. Los offsets son más limpios que las columnas de espaciado vacías.

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 y layout automático

row-cols-{n} fija cuántas columnas de igual ancho van por fila — mucho más limpio que añadir col-* a cada hijo cuando todas tienen el mismo ancho. row-cols-2 significa 2 columnas por fila; los ítems se envuelven automáticamente. Las variantes responsivas (row-cols-1 row-cols-md-3) cambian la cuenta por breakpoint. Un .col simple (sin número) hace que las columnas repartan el espacio por igual. Usa row-cols para cuadrículas de tarjetas; usa col-{n} cuando las columnas necesiten proporciones 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

Tipografía

Encabezados y display

Bootstrap estiliza h1-h6 con tamaños basados en rem (h1 = 2.5rem, h6 = 1rem). Las clases .h1-.h6 aplican estilos de encabezado a cualquier elemento. Los display headings (display-1 a display-6) son más grandes y finos — para secciones hero. .lead hace un párrafo un poco más grande y ligero — normalmente para el primer párrafo. Los encabezados no tienen margen superior por defecto (Reboot lo elimina) para evitar huecos en el 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 en línea

Bootstrap estiliza los elementos semánticos de HTML: <mark> (resaltado), <del>/<s> (tachado), <ins>/<u> (subrayado), <small> (letra pequeña). Las utilidades de texto aportan estilos: text-uppercase/lowercase/capitalize, fw-bold/light/normal, fst-italic, text-muted (gris). text-decoration-underline/line-through controlan los subrayados. Estas utilidades se prefieren a los estilos en línea por consistencia.

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 elimina el estilo por defecto de las listas (viñetas y padding izquierdo) — útil para menús de navegación. list-inline hace que los ítems de lista se muestren en línea (para nubes de etiquetas, migas de pan). Las listas de descripción (dl/dt/dd) obtienen un layout horizontal con la clase row — dt a la izquierda, dd a la derecha, alineados mediante la cuadrícula. Las listas en Bootstrap tienen margin-top: 0 y margin-bottom: 1rem para un espaciado 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>

Citas y código

Las citas usan la estructura <figure>/<blockquote>/<figcaption> por semántica. blockquote-footer estiliza la cita de la fuente. Estilos de código: <code> para código en línea, <pre><code> para bloques de código, <kbd> para teclas, <var> para variables. Escapa siempre los signos de menor/mayor en el código (&lt; para <). Las citas se pueden alinear con text-center/text-end. El estilo de kbd da a las teclas una apariencia 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>

Alineación y ajuste de texto

Alineación de texto: text-start/center/end (Bootstrap 5 renombró left/right a start/end por soporte RTL). Las variantes responsivas (text-md-start) cambian la alineación en breakpoints. text-nowrap evita el ajuste de línea; text-truncate añade puntos suspensivos al desbordarse (necesita un max-width o contenedor limitado). text-break rompe palabras largas. lh-* controla el interlineado. Estas utilidades gestionan el flujo de texto sin 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

Tablas

Tabla básica

La clase .table añade padding, bordes y divisores horizontales. Usa <thead> para los encabezados y <tbody> para los datos. scope='col' en los <th> del encabezado y scope='row' en los <th> de las filas mejoran la accesibilidad para lectores de pantalla. Las tablas son opt-in — sin .table obtienes tablas HTML sin estilo. Usa siempre elementos de tabla semánticos (thead, tbody, th, tr, td) por accesibilidad.

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 y rayado de tablas

Modificadores de tabla: table-striped (colores alternos por fila), table-bordered (bordes por los cuatro lados), table-borderless (sin bordes), table-hover (resalta la fila al pasar el ratón), table-sm (padding condensado), table-dark (tema oscuro). Se pueden combinar: table table-striped table-hover. La variante dark invierte los colores para fondos oscuros. table-sm reduce a la mitad el padding de las celdas para mostrar datos más 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>

Colores de tabla

Aplica clases contextuales a <tr> o <td>: table-primary, table-success, table-danger, table-warning, table-info, table-secondary, table-light, table-dark, table-active. Añaden tintes sutiles de fondo para indicar estado. En tablas oscuras, las mismas clases ofrecen variantes más claras. Úsalas con moderación y con significado (success para completado, danger para errores) en lugar de decoración.

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>

Tablas responsivas

Envuelve las tablas en .table-responsive para permitir scroll horizontal en pantallas pequeñas (evita que el layout se rompa). table-responsive-sm/md/lg/xl/xxl hace scroll solo por debajo de ese breakpoint — la tabla cabe con normalidad en pantallas mayores. Sin la envoltura responsiva, las tablas anchas desbordan su contenedor. El div envolvente es necesario porque overflow no puede aplicarse directamente a <table>. Úsalo siempre en tablas con muchas columnas.

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 tabla y captions

caption-top mueve el caption por encima de la tabla (por defecto va debajo). Los captions mejoran la accesibilidad para lectores de pantalla. Estiliza thead/tbody/tfoot por separado con table-light/table-dark. Alineación vertical: align-top, align-middle, align-bottom en celdas o filas — útil cuando las celdas tienen alturas de contenido distintas. El elemento tfoot se estiliza como thead por defecto pero puede personalizarse.

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

Formularios

Controles de formulario

form-control estiliza inputs de texto, textareas e inputs de archivo. form-select estiliza los desplegables. Empareja siempre los inputs con elementos <label> (con for/id coincidentes) por accesibilidad. form-label añade el espaciado adecuado. disabled impide la interacción; readonly muestra el valor sin editar. mb-3 (margin-bottom) añade espacio entre grupos del formulario. La clase .form-control aplica altura, padding y 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>

Cuadrícula y layout del formulario

Usa el sistema de cuadrícula (row/col) para maquetar formularios. Para formularios horizontales, empareja col-form-label con col-* para alinear etiqueta/input. row-cols-lg-auto hace que los elementos del formulario se dimensionen según su contenido (formulario en línea) en pantallas grandes. align-items-center alinea verticalmente las etiquetas con los inputs. La cuadrícula da control preciso del layout del formulario en distintos breakpoints sin 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>

Grupos de input

Los input groups anteponen o añaden texto/botones a los inputs usando input-group-text. Común para nombres de usuario con @, moneda con $, decimales .00 o botones de búsqueda. El envoltorio input-group hace que el addon y el input se vean como un control conectado. Varios inputs pueden compartir un addon. Los botones dentro de input groups usan btn-outline-* para un aspecto conectado. No mezcles input groups con 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>

Etiquetas flotantes

Las etiquetas flotantes animan la label desde dentro del input hasta encima de él cuando el campo recibe el foco o tiene contenido. La label debe ir DESPUÉS del input en el HTML. Se requiere un atributo placeholder (aunque esté vacío) para el comportamiento flotante. Este patrón ahorra espacio y luce moderno. No lo combines con input-group. Las etiquetas flotantes funcionan con inputs, textareas y selects. Son una alternativa limpia a las etiquetas tradicionales en formularios 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 -->

Validación

Bootstrap proporciona las clases is-valid e is-invalid para el estilo de validación, con valid-feedback e invalid-feedback para los mensajes. La clase needs-validation en el formulario, combinada con novalidate (desactiva los tooltips del navegador), permite usar la UI de validación de Bootstrap con JS personalizado. Al enviar, añade was-validated para mostrar cada estado de validación. Funciona con las restricciones de HTML5 (required, pattern, type) o con validación personalizada del 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

Botones

Variantes de botones

btn es la clase base de botón; btn-{color} define la variante. Los botones sólidos tienen fondo de color con texto blanco. Los botones outline (btn-outline-*) tienen fondo transparente con texto/bordes de color — buenos para acciones secundarias. btn-link hace que un botón parezca un enlace. Elige los colores con significado: success para confirmar, danger para eliminar, warning para precaución. No uses solo el color para transmitir significado — incluye 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>

Tamaños y estados de botones

Tamaños de botón: btn-lg, el predeterminado y btn-sm. El atributo disabled (en <button>) o la clase .disabled (en <a> o cuando no puedes usar el atributo) apagan el botón. .active añade una apariencia pulsada. Para botones a ancho completo, usa d-grid gap-2 (apila los botones y llenan el ancho). d-md-block vuelve al modo en línea en el breakpoint md — útil para ancho completo en móvil y automático en escritorio. La clase .disabled también fija 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 botones

btn-group agrupa botones horizontalmente con bordes conectados. btn-toolbar combina varios grupos con espaciado. btn-group-vertical apila los botones verticalmente. Añade siempre role='group' y aria-label por accesibilidad. Las clases de tamaño (btn-group-lg/sm) se aplican a cada botón del grupo. Los grupos de botones son la base de toolbars, controles segmentados e interfaces tipo paginación.

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>

Botones de alternancia y checkbox

btn-check es un checkbox/radio oculto que se empareja con una etiqueta btn para el comportamiento de alternancia. El input está oculto visualmente; la label (estilizada como botón) muestra el estado. Para una sola alternancia, usa un checkbox. Para opciones mutuamente excluyentes, usa radios con el mismo name. La apariencia del botón cambia al marcarse. autocomplete='off' evita que el navegador restaure el estado. Esta es la forma accesible de crear toggles con apariencia de botón.

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>

Botones dropdown

Los dropdowns necesitan data-bs-toggle='dropdown' en el botón de apertura. El menú es un ul.dropdown-menu con enlaces dropdown-item. dropdown-divider separa grupos. Los botones divididos (dropdown-toggle-split) tienen un botón de acción aparte y una flecha de apertura — añade texto visually-hidden por accesibilidad. dropdown-item.active marca la selección actual; .disabled la apaga. Los dropdowns requieren el bundle de JS de Bootstrap (incluye Popper para el posicionamiento).

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

Tarjetas

Tarjeta básica

Las cards son contenedores flexibles con header, body y footer opcionales. card-img-top coloca una imagen arriba. card-title, card-subtitle y card-text estilizan el contenido. El ancho lo controla la cuadrícula padre o un atributo style — las cards por defecto ocupan el ancho completo. card-header y card-footer son para contenido estructurado. Las cards reemplazaron los panels, wells y thumbnails de Bootstrap 3 con un único 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 contenido de las tarjetas

Las cards pueden contener varios tipos de contenido: imágenes, texto, list groups (usa list-group-flush para quitar bordes y que coincidan con los bordes de la card) y enlaces (card-link añade espaciado). Mezcla y combina secciones — card-body, list-group, card-header, card-footer — para construir exactamente la card que necesites. list-group-flush integra las listas a la perfección sin bordes dobles. Esta flexibilidad hace de las cards el componente más versátil de 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>

Cuadrícula y grupos de tarjetas

card-group conecta cards con bordes compartidos y alturas iguales. Para cuadrículas de cards responsivas, usa el sistema de cuadrícula: row row-cols-1 row-cols-md-3 g-4 da 1 columna en móvil, 3 en escritorio, con espaciado gap-4. Cada card va en un .col. El enfoque de cuadrícula es más flexible que card-group — las cards pueden tener alturas independientes y controlas la envoltura. Usa card-group solo cuando necesites cards conectadas y de igual 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>

Navegación en tarjetas

Añade navegación a las cards con nav-tabs o nav-pills en el card-header. card-header-tabs y card-header-pills integran la nav a ras de los bordes del header. Usa nav-link active para la pestaña actual y nav-link disabled para las inactivas. Para que las pestañas funcionen (cambien el contenido), añade data-bs-toggle='tab' y los tab panes — el JS de Bootstrap gestiona el cambio. Este patrón es común en dashboards y tarjetas de contenido con varias vistas.

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 y overlay de tarjetas

Variantes de color de card: bg-{color} con text-white/text-dark para fondos sólidos; border-{color} con text-{color} para bordes de color. card-img-overlay coloca texto sobre una imagen (card-img llena la card, el contenido del overlay se sitúa encima) — usa text-bg-dark para texto legible sobre imágenes. text-center/text-start/text-end controlan la alineación del texto. En overlays sobre imágenes oscuras, asegura suficiente contraste entre texto e imagen.

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ásicas

Las alerts muestran mensajes de retroalimentación contextual. alert-{variant} fija el color (primary, success, danger, warning, info, light, dark). role='alert' es para la accesibilidad de lectores de pantalla. alert-link estiliza los enlaces para que coincidan con el color de la alerta. Usa alerts para: retroalimentación de validación de formularios, resultados de acciones (¡guardado! ¡eliminado!) o avisos importantes. Elige los colores con semántica: success para positivo, danger para errores, warning para precaución, info para información neutral.

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 descartables

alert-dismissible añade padding para el botón de cierre; btn-close con data-bs-dismiss='alert' lo cierra. fade show habilita la transición de desvanecimiento. Una vez descartada, la alerta se elimina del DOM (no solo se oculta). Vía JS, crea una instancia de Alert y llama a close(). El evento closed.bs.alert se dispara tras la eliminación. Si quieres mostrarla de nuevo, debes recrear el elemento del DOM. Para descartes persistentes (no volver a mostrar), guarda el estado en 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 con iconos y contenido

Las alerts pueden contener contenido rico: encabezados (alert-heading), párrafos, divisores (hr), iconos y botones de acción. Para los iconos, usa Bootstrap Icons (clase bi) o SVG con alineación flex. d-flex align-items-center centra verticalmente el icono y el texto. Incluye botones de acción (como 'Extender' para avisos de sesión) junto al botón de cierre. Las alerts no son solo para texto — son contenedores flexibles para retroalimentación importante y descartable.

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>

Notificaciones toast

Los toasts son notificaciones ligeras (como los toasts de Android). Se ocultan solos tras un retardo (5s por defecto). Envuélvelos en toast-container para apilarlos. position-fixed con top-0 end-0 los fija arriba a la derecha. aria-live='assertive' los anuncia a los lectores de pantalla. toast-header tiene icono, título, marca de tiempo y botón de cierre; toast-body tiene el mensaje. A diferencia de las alerts, los toasts no bloquean la UI — son no intrusivos. Úsalos para '¡Guardado!', 'Nuevo mensaje' o tareas en segundo plano terminadas.

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ón de alerta en vivo

Para alertas actualizadas dinámicamente (mensajes de estado, progreso), usa aria-live='polite' — los lectores de pantalla anuncian los cambios sin interrumpir. aria-live='assertive' anuncia de inmediato (para errores críticos). aria-atomic='true' lee el contenido completo al cambiar (no solo la parte modificada). role='alert' es implícitamente assertive. Este patrón de accesibilidad garantiza que los usuarios de lectores de pantalla oigan las actualizaciones dinámicas. Combínalo con las clases alert para el 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

Los badges son pequeños indicadores de contador/etiqueta. bg-{color} fija el fondo; añade text-dark sobre fondos claros (warning, info, light) para contraste. Los badges escalan respecto al font-size de su elemento padre — un badge en un h1 es más grande que en un p. Usa badges para: contadores de no leídos, etiquetas de estado, tags de 'Nuevo', números de versión. Son elementos en línea que encajan en el flujo 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 y redondeados

rounded-pill hace badges totalmente redondeados (forma de píldora). rounded-0 a rounded-3 controlan la escala del border-radius. rounded-circle con padding crea badges circulares — útil para contadores de notificaciones. Para círculos perfectos con un solo dígito, fija el mismo ancho y alto y usa d-flex align-items-center justify-content-center. Los badges pill son comunes para tags e indicadores de estado.

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 en botones y nav

Badges en botones: position-relative en el botón, position-absolute en el badge con top-0 start-100 translate-middle para colocarlo en la esquina superior derecha. El texto visually-hidden dentro del badge da contexto a los lectores de pantalla. Los badges en enlaces de nav e ítems de lista muestran contadores — usa justify-content-between para empujarlos a la derecha. El patrón '99+' es habitual cuando los contadores superan el límite de visualización.

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 (punto)

Los badges de punto (sin texto, solo un círculo de color) indican estado sin contador — como 'no leído' u 'online'. Usa p-1 con rounded-circle para un punto pequeño y border-light para separarlo del fondo. Posiciónalo con la misma técnica de translate-middle. Los puntos de estado online (verde = en línea, gris = desconectado) van en la esquina inferior de los avatares. Los badges también pueden envolver iconos (Bootstrap Icons: bi bi-star-fill) con texto para valoraciones.

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 y grow

Los spinners indican estado de carga. spinner-border es un anillo giratorio; spinner-grow es un círculo pulsante. text-* les da color. spinner-border-sm/grow-sm son más pequeños. Tamaños personalizados vía CSS width/height. Incluye siempre role='status' con texto visually-hidden por accesibilidad. En botones, usa spinner-border-sm con disabled para mostrar una acción en carga. Los spinners son solo CSS (sin JS) — se animan mediante transiciones de border y opacity.

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

Progreso y spinners

Barra de progreso básica

Las barras de progreso muestran la finalización de una tarea. Fija el ancho como porcentaje mediante estilo en línea. role='progressbar' con aria-valuenow/min/max es por accesibilidad. La altura se fija en el contenedor .progress (1rem por defecto). bg-{color} en la barra cambia su color. El texto de etiqueta dentro de la barra es opcional — omítelo en barras minimalistas. Fija siempre el ancho vía style (no con clases), ya que los valores son 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>

Progreso rayado y animado

progress-bar-striped añade rayas diagonales. progress-bar-animated hace que las rayas se muevan (para tareas activas/en curso). Usa la animación solo para tareas en ejecución — barras estáticas para las completadas. Actualiza el progreso vía JS cambiando style.width y aria-valuenow. La animación usa CSS — no hace falta JS para el movimiento. Combina bg-* con striped para barras rayadas de color.

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>

Barras de progreso múltiples

Varios divs progress-bar dentro de un mismo contenedor .progress se apilan lado a lado — cada uno toma su porcentaje del ancho total. Es útil para mostrar composición (por ejemplo, almacenamiento: 25% fotos, 30% vídeos, 20% apps). Las barras comparten la misma altura y quedan contiguas sin huecos. El total debería idealmente sumar 100% (o menos si está incompleto). Cada una puede tener su propio color y etiqueta.

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

Carga con esqueletos

Los placeholders (carga tipo skeleton) muestran bloques grises donde aparecerá el contenido — mejor que los spinners para páginas con mucho contenido. placeholder-glow crea un brillo pulsante; placeholder-wave crea una onda en movimiento. col-* fija el ancho de cada bloque. Para tarjetas skeleton, usa placeholder dentro de los componentes card con aria-hidden='true'. Esto da a los usuarios una vista previa del layout antes de que lleguen los datos, reduciendo la espera percibida.

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>

Deslizador de rango

form-range estiliza el input range nativo (deslizador). Fija los atributos min, max y step para el rango y el incremento. El deslizador ocupa el ancho completo por defecto. Para mostrar el valor, usa oninput para actualizar una etiqueta mientras el usuario arrastra. Disabled lo apaga. Los inputs range son buenos para volumen, opacidad o cualquier valor continuo donde no se necesita precisión exacta. Emparéjalo siempre con una label por accesibilidad.

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

Clases utilitarias

Espaciado (margen y padding)

Las utilidades de espaciado siguen {property}{sides}-{size}. m = margin, p = padding. Lados: t/b (top/bottom), s/e (start/end — left/right en LTR), x (izquierda+derecha), y (arriba+abajo), en blanco (los cuatro lados). Los tamaños 0-5 corresponden a la escala de espaciado (0, 0.25rem, 0.5rem, 1rem, 1.5rem, 3rem). mx-auto centra elementos de bloque. Responsivo: añade el breakpoint (mt-md-3). Bootstrap 5 renombró left/right a start/end por soporte 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>

Colores y fondos

text-{color} fija el color del texto; bg-{color} el fondo. text-bg-{color} (Bootstrap 5.2+) fija automáticamente un color de texto contrastado para el fondo. bg-gradient añade un degradado sutil. Opacidad: text-opacity-50 o bg-opacity-50 (10%, 25%, 50%, 75%, 100%). text-muted es gris (texto secundario). Asegura siempre suficiente contraste entre texto y fondo — usa text-white sobre fondos oscuros. Los colores llevan significado semántico (success=verde, danger=rojo).

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 y flexbox

d-* fija la propiedad display (d-none oculta elementos). Las variantes responsivas d-{breakpoint}-* cambian el display por breakpoint — d-none d-md-block oculta en móvil y muestra en escritorio. d-flex habilita flexbox; flex-direction, justify-content-*, align-items-* y flex-wrap controlan el layout flex. Estas utilidades reemplazan la mayor parte del CSS personalizado de layout. d-md-flex activa flex solo en md+. Combínalas para layouts responsivos complejos sin 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>

Posición y floats

position-* fija la posición CSS. position-sticky con top-0 crea un encabezado pegajoso (se pega al hacer scroll). top/bottom/start/end (0 o 50%) fijan los insets. translate-middle centra elementos (combina top-50 start-50 para centrado perfecto). Los floats (float-start/end) son herencia — usa flexbox para el layout. clearfix limpia los hijos flotados. fixed-top/fixed-bottom fijan elementos al viewport. Sticky se prefiere sobre fixed para navbars porque no se superpone al contenido al inicio.

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>

Bordes, sombras y radios

border añade o elimina bordes en lados específicos. border-{color} los colorea; border-{1-5} fija el ancho. rounded-* controla el border-radius: rounded-0 (ninguno), rounded (por defecto), rounded-3 (mayor), rounded-pill (cápsula), rounded-circle (50%). rounded-{side} redondea solo esquinas concretas. shadow-* añade sombras: none, sm, predeterminada, lg. Las sombras dan profundidad — usa shadow-sm para una elevación sutil y shadow-lg para modals/elementos flotantes. Estas utilidades cubren la mayoría del estilo visual sin 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

Imágenes y figuras

Imágenes responsivas

img-fluid hace las imágenes responsivas (max-width: 100%, height: auto) — nunca desbordan su contenedor. w-100 fuerza el ancho completo. figure/figure-img/figure-caption aportan imagen con caption semántica (mejor que div + p). float-start/end alinea imágenes; mx-auto d-block centra. rounded añade esquinas redondeadas. Incluye siempre texto alt por accesibilidad — describe la imagen para los lectores de pantalla. Para imágenes decorativas, usa 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 imagen y thumbnails

Formas de imagen: rounded (esquinas redondeadas), rounded-circle (circular — funciona mejor en imágenes cuadradas), rounded-pill (cápsula). img-thumbnail añade borde, padding y esquinas redondeadas — da un aspecto de foto impresa. Combina img-thumbnail con rounded-circle para un thumbnail circular. Para avatares, fija width/height explícitos para reservar espacio y evitar saltos de layout. Las clases de forma funcionan en cualquier elemento, no solo en imágenes — útiles para thumbnails de vídeo o 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">

Figures y captions

figure es el elemento semántico de HTML para imágenes con caption — mejor para la accesibilidad que los divs. figure-img estiliza la imagen (combínalo con img-fluid y rounded). figure-caption estiliza el texto del caption (atenuado por defecto). text-start/center/end alinea el caption. Envuelve la imagen en un <a> para ampliaciones clicables. Las figures son la elección semántica correcta para contenido editorial, documentación y galerías.

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>

Imágenes de fondo

Bootstrap no tiene utilidades de background-image (las imágenes dependen del contenido), así que usa estilos en línea. background-size: cover llena el contenedor sin distorsión; background-position: center enfoca el centro. Para texto sobre imágenes, añade una capa de degradado (oscura abajo) para legibilidad. position-relative en un envoltorio con capas position-absolute permite apilar imagen, overlay y texto. Este es el patrón para secciones hero y tarjetas con imagen.

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>

Cuadrícula y galería de imágenes

Las cuadrículas de imágenes usan el sistema estándar row/col con g-* para los gutters. Para imágenes de igual altura sin importar la relación de aspecto, fija un contenedor de altura determinada y usa object-fit: cover en el img con w-100 h-100. row-cols-* crea columnas de igual ancho sin especificar col-* en cada ítem. Para masonry de verdad (alturas variables, sin huecos) se necesitan columnas CSS o librerías de JavaScript — la cuadrícula de Bootstrap no hace masonry de forma nativa. img-fluid garantiza que las imágenes nunca desborden sus celdas de la cuadrícula.

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 y acordeón

Collapse básico

Collapse alterna la visibilidad de un elemento con una animación de altura. Disparador: data-bs-toggle='collapse' con data-bs-target (botón) o href (ancla) apuntando al id del elemento colapsable. .collapse está oculto; .collapse.show es visible. aria-expanded en el disparador refleja el estado; aria-controls vincula disparador y objetivo. Usa botones para acciones y anclas para navegación. La animación transiciona suavemente la altura de 0 a auto.

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>

Acordeón

El acordeón es un grupo de collapses donde data-bs-parent garantiza que solo uno está abierto a la vez (abrir uno cierra los demás). Estructura: accordion > accordion-item > accordion-header (con accordion-button) + accordion-collapse (con accordion-body). El primer ítem puede llevar la clase 'show' para empezar expandido. La clase 'collapsed' en el botón indica el estado colapsado (rota la flecha). aria-expanded y aria-controls son esenciales por accesibilidad. El atributo parent crea el comportamiento de apertura 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>

Acordeón flush y variantes

accordion-flush elimina los bordes exteriores y el fondo — para integrarlo en cards o contenedores sin bordes dobles. Sin data-bs-parent en los ítems del collapse, varias secciones pueden permanecer abiertas simultáneamente (modo always-open). Con data-bs-parent, abrir una cierra las demás (acordeón estándar). Elige según la UX: exclusivo (una abierta) para FAQs donde se lee una a la vez; multiapertura para navegación o ajustes donde el usuario puede comparar secciones.

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 vía JavaScript

Controla el collapse vía JS: new bootstrap.Collapse(el, options). toggle: false evita la alternancia automática al inicializar. parent: selector crea el comportamiento de acordeón (cierra los hermanos). Funciones: show(), hide(), toggle(), dispose(). Eventos: show/shown/hide/hidden.bs.collapse — usa shown/hidden (pasado) para acciones posteriores a la animación, como enfocar un input o actualizar aria. Útil para control programático, como expandir una sección según el hash de la URL o el estado de un formulario.

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 multiobjetivo

data-bs-target acepta selectores CSS, así que un disparador puede alternar varios elementos — usa una clase compartida (.multi-collapse) para apuntar a cada uno. A la inversa, varios disparadores pueden controlar el mismo objetivo (cada uno con data-bs-target='#shared'). Es útil para botones de mostrar/ocultar en bloque que controlan varias secciones, o para layouts responsivos donde botones distintos controlan el mismo panel desde lugares diferentes. El enfoque de selectores es muy flexible.

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

Iconos y accesibilidad

Bootstrap Icons

Bootstrap Icons es una librería de iconos aparte (no incluida en el CSS). Incluye el CSS y usa <i class='bi bi-{name}'></i>. Dimensiona los iconos con utilidades fs-* (font-size). Colórealos con clases text-*. Los iconos en botones mejoran la UX con señales visuales. Los botones de solo icono DEBEN tener aria-label para los lectores de pantalla — sin él, el botón no tiene nombre accesible. Explora los iconos en icons.getbootstrap.com. Los iconos son fuentes SVG, así que escalan con nitidez a cualquier tamaño.

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>

Accesibilidad: ARIA y roles

Los componentes de Bootstrap incluyen atributos ARIA, pero debes añadirlos en los controles personalizados. aria-label da nombres a los botones de solo icono. aria-labelledby referencia el id de otro elemento como etiqueta. aria-describedby apunta a texto de ayuda. aria-expanded refleja el estado de alternancia (true/false). aria-current='page' marca el ítem de navegación actual. Usa HTML semántico (nav, main, aside, header, footer), que tienen roles ARIA implícitos — mejor que añadir 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 y lectores de pantalla

visually-hidden oculta el contenido visualmente pero lo mantiene para los lectores de pantalla — úsalo para etiquetas de botones de solo icono o contexto extra. visually-hidden-focusable está oculto hasta recibir el foco del teclado (perfecto para enlaces 'Saltar al contenido principal' que aparecen al tabular). aria-hidden='true' hace lo contrario: visible pero no anunciado (para elementos decorativos). Proporciona siempre un skip link como primer elemento enfocable para la accesibilidad de teclado. Son esenciales para cumplir 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>

Movimiento reducido y modo oscuro

Modo oscuro: fija data-bs-theme='dark' en <html> — Bootstrap intercambia las variables CSS. Alterna vía JS cambiando el atributo. Respeta la preferencia del sistema con matchMedia('(prefers-color-scheme: dark)'). Para el movimiento reducido, Bootstrap desactiva automáticamente la mayoría de animaciones cuando el usuario tiene prefers-reduced-motion: reduce. Puedes añadir más reglas para reducir aún más el movimiento. Guarda la preferencia de tema del usuario en localStorage. Estas características hacen tu sitio accesible y cómodo para cada usuario.

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;
  }
}

Gestión del foco y teclado

Nunca elimines los contornos de foco (outline: none) sin dar una alternativa — los usuarios de teclado los necesitan. El focus-visible de Bootstrap muestra el anillo solo con el foco de teclado, no con el ratón. En los modals, mueve el foco dentro del modal al mostrarse y devuélvelo al disparador al ocultarse. Los widgets personalizados (pestañas, menús) necesitan navegación con flechas — implementa manejadores keydown para las teclas de flecha, Enter, Space y Escape. Una gestión correcta de tabindex (0 para enfocables, -1 para enfocables programáticamente) garantiza un orden de tabulación lógico. Es esencial para usuarios de solo 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 es un componente flexible para mostrar una serie de contenido. list-group-item estiliza cada entrada. active marca el ítem actual; disabled lo apaga (usa aria-disabled='true' por accesibilidad). Los list groups son más semánticos que los divs estilizados para listas de contenido relacionado como dashboards, ajustes o bandejas de entrada. Usa <ul>/<li> para listas de navegación, o <div> para contenido que no es 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 con enlaces y botones

Para ítems de lista accionables (clicables), usa list-group-item-action en elementos <a> o <button>. Esto añade estados hover y focus. Usa <a> para navegación (con href) y <button type='button'> para acciones. Desactiva los enlaces con la clase .disabled (y aria-disabled); desactiva los botones con el atributo disabled. Evita usar <li> para ítems accionables — usa <div> como envoltorio del list-group, ya que <a>/<button> dentro de <ul> es 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 y numerado

list-group-flush elimina bordes y esquinas redondeadas — para incrustarlo en cards o contenedores sin bordes dobles. list-group-numbered (en <ol>) añade numeración automática mediante contadores CSS. list-group-horizontal coloca los ítems lado a lado; las variantes responsivas (list-group-horizontal-md) pasan a horizontal en un breakpoint. Las listas horizontales son útiles para navegación pequeña o barras de filtro. Las listas numeradas son geniales para instrucciones paso a paso o 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>

Colores contextuales y badges del list group

Las clases contextuales (list-group-item-{color}) tiñen los ítems para indicar estado — úsalas con significado (success=hecho, danger=error). Para badges dentro de los ítems, usa d-flex justify-content-between align-items-center para empujar el badge a la derecha y centrarlo verticalmente. Los badges rounded-pill lucen modernos para contadores. Este patrón es la clásica lista de bandeja de entrada/notificaciones: etiqueta a la izquierda, contador a la derecha. Las utilidades flex manejan la alineación sin 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>

Contenido personalizado del list group

Los ítems de lista pueden contener contenido rico: encabezados (fw-bold), descripciones (text-muted), metadatos (small) y badges. Usa d-flex justify-content-between align-items-start para disponer el contenido y el badge. me-auto empuja el badge a la derecha. Para checkboxes/radios en los ítems, usa form-check-input con su form-check-label correspondiente — esto crea listas seleccionables. Casos de uso comunes: listas de correo, paneles de ajustes y resultados de búsqueda donde cada ítem tiene título, descripción y estado.

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.