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.
<!-- 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 JSContenedores
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.
<!-- 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 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.
<!-- 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.
: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>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.
<!-- .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.
<!-- 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-*.
<!-- 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.
<!-- 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's z-index scale */
/* z-1 to z-3, plus z-n0, z-n1, z-n2 for negatives */
<div class="z-3 position-relative">High z-index</div>
<div class="z-1 position-relative">Low z-index</div>
<!-- components have built-in z-index: -->
/* dropdown: 1000 */
/* sticky: 1020 */
/* fixed: 1030 */
/* modal-backdrop: 1050 */
/* modal: 1055 */
/* popover: 1070 */
/* tooltip: 1080 */
<!-- use position utilities for stacking context -->
<div class="position-relative z-3">
Needs position for z-index to apply
</div>Sistema de 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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 -->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.
<!-- 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.
<!-- 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.
<!-- 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 (< para <). Las citas se pueden alinear con text-center/text-end. El estilo de kbd da a las teclas una apariencia de teclado.
<!-- blockquote with source -->
<figure>
<blockquote class="blockquote">
<p>A well-known quote.</p>
</blockquote>
<figcaption class="blockquote-footer">
Someone famous in <cite title="Source Title">Source Title</cite>
</figcaption>
</figure>
<!-- blockquote alignment -->
<blockquote class="blockquote text-center">Centered</blockquote>
<blockquote class="blockquote text-end">Right-aligned</blockquote>
<!-- inline code -->
<p>Use <code><section></code> tag.</p>
<!-- code block -->
<pre><code><div class="container">
Hello
</div>
</code></pre>
<!-- variables -->
<var>y</var> = <var>mx</var> + <var>b</var>
<!-- keyboard input -->
<kbd>Ctrl</kbd> + <kbd>C</kbd>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.
<!-- 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>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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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>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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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 -->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.
<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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- colored card -->
<div class="card text-white bg-primary">
<div class="card-header">Header</div>
<div class="card-body">
<h5 class="card-title">Primary card</h5>
<p class="card-text">Text on colored background.</p>
</div>
</div>
<!-- border colored card -->
<div class="card border-primary">
<div class="card-header border-primary">Header</div>
<div class="card-body text-primary">
<h5 class="card-title">Primary border</h5>
</div>
</div>
<!-- image overlay (text over image) -->
<div class="card text-bg-dark">
<img src="..." class="card-img">
<div class="card-img-overlay">
<h5 class="card-title">Overlay title</h5>
<p class="card-text">Text over the image.</p>
</div>
</div>
<!-- text alignment -->
<div class="card text-center">Centered text</div>
<div class="card text-end">Right-aligned</div>Modals
Modal básico
Los modals se disparan con data-bs-toggle='modal' y data-bs-target que coincida con el id del modal. Estructura: modal > modal-dialog > modal-content > modal-header/body/footer. btn-close es el botón X (data-bs-dismiss='modal'). fade añade una transición. tabindex='-1' y aria-hidden son por accesibilidad. El modal está oculto por defecto y se posiciona con position fixed. El JS de Bootstrap gestiona mostrar, ocultar, el backdrop y el foco.
<!-- Button to trigger -->
<button type="button" class="btn btn-primary" data-bs-toggle="modal"
data-bs-target="#exampleModal">
Launch demo modal
</button>
<!-- Modal -->
<div class="modal fade" id="exampleModal" tabindex="-1"
aria-labelledby="exampleModalLabel" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="exampleModalLabel">Modal title</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal"
aria-label="Close"></button>
</div>
<div class="modal-body">
Modal body text goes here.
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
<button type="button" class="btn btn-primary">Save changes</button>
</div>
</div>
</div>
</div>Tamaño y scroll del modal
Tamaños de modal: modal-sm, el predeterminado, modal-lg, modal-xl, modal-fullscreen. modal-fullscreen-{breakpoint}-down es pantalla completa solo por debajo de ese breakpoint. modal-dialog-scrollable hace que el body haga scroll (header/footer fijos) — esencial para contenido largo. modal-dialog-centered centra el modal verticalmente. Estas clases van en modal-dialog. Combínalas: modal-dialog modal-dialog-centered modal-dialog-scrollable para un modal centrado y con scroll.
<!-- sizes -->
<div class="modal-dialog modal-sm">Small</div>
<div class="modal-dialog">Default</div>
<div class="modal-dialog modal-lg">Large</div>
<div class="modal-dialog modal-xl">Extra large</div>
<div class="modal-dialog modal-fullscreen">Fullscreen</div>
<!-- responsive fullscreen -->
<div class="modal-dialog modal-fullscreen-sm-down">
<!-- fullscreen below sm, normal above -->
</div>
<!-- scrollable long content -->
<div class="modal-dialog modal-dialog-scrollable">
<div class="modal-content">
<div class="modal-body">
<!-- long content scrolls within modal -->
</div>
</div>
</div>
<!-- vertically centered -->
<div class="modal-dialog modal-dialog-centered">
<!-- centered vertically in viewport -->
</div>Modal vía JavaScript
Controla los modals vía JS: crea una instancia con new bootstrap.Modal(el) y luego show()/hide()/toggle(). backdrop: 'static' impide cerrar al hacer clic en el fondo; keyboard: false desactiva Esc. Eventos: show.bs.modal, shown.bs.modal, hide.bs.modal, hidden.bs.modal (show = empezando, shown = terminado). Usa shown.bs.modal para enfocar un input o cargar contenido dinámico. El backdrop estático es útil para formularios donde un cierre accidental perdería datos.
<!-- HTML modal (hidden) -->
<div class="modal fade" id="myModal" tabindex="-1">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-body">Dynamic content here</div>
</div>
</div>
</div>
<script>
// create modal instance
const modalEl = document.getElementById('myModal')
const modal = new bootstrap.Modal(modalEl)
// show
modal.show()
// hide
modal.hide()
// toggle
modal.toggle()
// handle events
modalEl.addEventListener('shown.bs.modal', () => {
console.log('modal fully shown')
})
modalEl.addEventListener('hidden.bs.modal', () => {
console.log('modal fully hidden')
})
// pass options
const modal = new bootstrap.Modal(modalEl, {
backdrop: 'static', // don't close on backdrop click
keyboard: false // don't close on Esc
})
</script>Tooltips y popovers
Los tooltips se muestran al pasar el ratón/con el foco; los popovers al hacer clic. Ambos necesitan inicialización JS (Bootstrap no auto-inicializa por rendimiento). data-bs-placement fija la posición (top/bottom/left/right). Los popovers tienen title + content; data-bs-html='true' permite HTML. data-bs-trigger='focus' hace los popovers descartables (clic fuera). Tooltips y popovers usan Popper.js (incluido en el bundle) para un posicionamiento inteligente. Son ideales para pistas, definiciones e información contextual.
<!-- tooltip (hover/focus) -->
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip"
data-bs-placement="top" title="Tooltip on top">
Hover me
</button>
<!-- positions: top, bottom, left, right -->
<button data-bs-toggle="tooltip" data-bs-placement="right"
title="Right tooltip">Right</button>
<!-- popover (click) -->
<button type="button" class="btn btn-lg btn-danger" data-bs-toggle="popover"
title="Popover title" data-bs-content="Content here">
Click to toggle popover
</button>
<!-- popover with HTML content -->
<button data-bs-toggle="popover" data-bs-html="true"
data-bs-content="<b>Bold</b> content">HTML popover</button>
<!-- dismissible popover -->
<button data-bs-toggle="popover" data-bs-trigger="focus"
title="Dismissible">Click outside to dismiss</button>
<script>
// MUST initialize tooltips and popovers
const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]')
tooltipTriggerList.forEach(t => new bootstrap.Tooltip(t))
const popoverTriggerList = document.querySelectorAll('[data-bs-toggle="popover"]')
popoverTriggerList.forEach(p => new bootstrap.Popover(p))
</script>Offcanvas (panel deslizante)
Offcanvas es un panel deslizante (como un modal pero desde el borde). offcanvas-start/end/top/bottom fija la dirección de deslizamiento. La estructura refleja la del modal: offcanvas-header/body con btn-close. data-bs-backdrop='static' impide cerrar al hacer clic en el fondo. text-bg-dark para la variante oscura. Offcanvas es ideal para navegación móvil, filtros o paneles laterales. A diferencia de los modals, no cubre toda la pantalla — es un panel superpuesto. Reemplaza navbar-collapse con offcanvas para menús móviles modernos.
<!-- trigger button -->
<button class="btn btn-primary" data-bs-toggle="offcanvas"
data-bs-target="#demoOffcanvas">
Open offcanvas
</button>
<!-- offcanvas drawer -->
<div class="offcanvas offcanvas-start" tabindex="-1" id="demoOffcanvas">
<div class="offcanvas-header">
<h5 class="offcanvas-title">Title</h5>
<button type="button" class="btn-close" data-bs-dismiss="offcanvas"></button>
</div>
<div class="offcanvas-body">
<p>Content for the offcanvas.</p>
</div>
</div>
<!-- positions: start (left), end (right), top, bottom -->
<div class="offcanvas offcanvas-end" id="rightDrawer">Right side</div>
<div class="offcanvas offcanvas-top" id="topDrawer">Top</div>
<!-- dark variant -->
<div class="offcanvas offcanvas-start text-bg-dark" id="darkDrawer">
Dark offcanvas
</div>
<!-- static backdrop (no close on click outside) -->
<div class="offcanvas" data-bs-backdrop="static">...</div>Alertas
Alertas bá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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- aria-live for dynamic alerts -->
<div class="alert alert-info" role="alert" aria-live="polite"
aria-atomic="true" id="statusAlert">
<!-- content updated dynamically -->
</div>
<script>
// update alert content
function showStatus(message, type = 'info') {
const alert = document.getElementById('statusAlert')
alert.className = 'alert alert-' + type
alert.textContent = message
}
showStatus('Loading...', 'info')
// later:
showStatus('Data loaded!', 'success')
<!-- aria-live="polite" announces updates without interrupting -->
<!-- aria-live="assertive" interrupts immediately (urgent) -->
<!-- for form errors, use role="alert" (assertive by default) -->
<div role="alert" class="alert alert-danger" id="formError">
Please fix the errors below.
</div>
</script>Badges
Badges básicos
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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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>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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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">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.
<!-- 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).
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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>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=''.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- responsive image grid -->
<div class="row g-2">
<div class="col-6 col-md-4">
<img src="1.jpg" class="img-fluid rounded" alt="">
</div>
<div class="col-6 col-md-4">
<img src="2.jpg" class="img-fluid rounded" alt="">
</div>
<div class="col-6 col-md-4">
<img src="3.jpg" class="img-fluid rounded" alt="">
</div>
<div class="col-6 col-md-4">
<img src="4.jpg" class="img-fluid rounded" alt="">
</div>
</div>
<!-- equal-height images with object-fit -->
<div class="row g-3">
<div class="col-md-4">
<div style="height: 200px;">
<img src="tall.jpg" class="w-100 h-100"
style="object-fit: cover;" alt="">
</div>
</div>
</div>
<!-- masonry-like with columns -->
<div class="row row-cols-1 row-cols-md-3 g-3">
<div class="col"><img src="1.jpg" class="img-fluid rounded"></div>
<div class="col"><img src="2.jpg" class="img-fluid rounded"></div>
</div>Dropdowns
Dropdown básico
Los dropdowns necesitan: un disparador (botón o ancla con data-bs-toggle='dropdown') y un ul.dropdown-menu con elementos dropdown-item. Los ítems pueden ser <a> (para navegación) o <button> (para acciones). aria-expanded refleja el estado abierto. El dropdown se posiciona debajo del disparador por defecto (Popper.js se encarga del posicionamiento). Hacer clic fuera lo cierra. El bundle de JS (incluido Popper) es necesario para que los dropdowns funcionen.
<!-- dropdown -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" type="button"
data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<li><a class="dropdown-item" href="#">Something else</a></li>
</ul>
</div>
<!-- dropdown with button (not link) items -->
<ul class="dropdown-menu">
<li><button class="dropdown-item" type="button">Action</button></li>
<li><button class="dropdown-item" type="button">Another</button></li>
</ul>
<!-- via anchor tag (for non-button triggers) -->
<a class="btn btn-secondary dropdown-toggle" role="button"
data-bs-toggle="dropdown" aria-expanded="false">
Link dropdown
</a>Contenido del menú dropdown
Los menús dropdown pueden contener: dropdown-header (título de sección), dropdown-divider (línea separadora), dropdown-item (enlaces/botones), dropdown-item-text (texto no clicable), ítems active/disabled. Formularios dentro de dropdowns: añade padding p-4 y usa la clase dropdown-menu en el propio formulario. Es genial para dropdowns de login o formularios de filtro. Agrupa los ítems relacionados con headers y divisores para menús fáciles de escanear.
<ul class="dropdown-menu">
<!-- header -->
<li><h6 class="dropdown-header">Dropdown header</h6></li>
<!-- items -->
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
<!-- divider -->
<li><hr class="dropdown-divider"></li>
<!-- active item -->
<li><a class="dropdown-item active" href="#">Active</a></li>
<!-- disabled item -->
<li><a class="dropdown-item disabled">Disabled</a></li>
<!-- text item -->
<li><span class="dropdown-item-text">Just text</span></li>
</ul>
<!-- dropdown with form -->
<form class="dropdown-menu p-4">
<div class="mb-3">
<label class="form-label">Email</label>
<input type="email" class="form-control" placeholder="[email protected]">
</div>
<button type="submit" class="btn btn-primary">Sign in</button>
</form>Alineación del dropdown
dropdown-menu-end alinea el menú a la derecha. dropdown-menu-{breakpoint}-end alinea a la derecha solo en ese breakpoint. dropup/dropend/dropstart cambian la dirección de apertura (usa dropup para menús al pie de la página). data-bs-offset='x,y' desplaza la posición del menú. data-bs-auto-close='outside' mantiene el menú abierto al hacer clic dentro (útil para dropdowns con formulario). Estas opciones cubren la mayoría de necesidades de posicionamiento sin CSS personalizado.
<!-- default: aligned left below trigger -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Left-aligned
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- right-aligned menu -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Right-aligned
</button>
<ul class="dropdown-menu dropdown-menu-end">...</ul>
</div>
<!-- responsive alignment -->
<ul class="dropdown-menu dropdown-menu-lg-end">
<!-- left on mobile, right on lg+ -->
</ul>
<!-- dropup (menu opens above) -->
<div class="dropup">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Dropup
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- dropend (right) / dropstart (left) -->
<div class="dropend">...</div>
<div class="dropstart">...</div>
<!-- menu offset -->
<button data-bs-toggle="dropdown" data-bs-offset="10,20">
Offset menu
</button>Dropdown vía JavaScript
Controla los dropdowns vía JS: new bootstrap.Dropdown(el) crea una instancia. show()/hide()/toggle() lo controlan programáticamente. Opciones de autoClose: true (por defecto, cierra con cualquier clic), 'inside' (solo cierra al clicar un ítem), 'outside' (cierra al clicar fuera), false (nunca cierra solo — cierre manual). Eventos: show/shown/hide/hidden.bs.dropdown. Usa shown.bs.dropdown para cargar contenido dinámico o enfocar un ítem concreto. Útil para dropdowns dinámicos guiados por datos.
<!-- HTML -->
<div class="dropdown">
<button class="btn btn-secondary" id="dropdownBtn">
Toggle via JS
</button>
<ul class="dropdown-menu" id="myDropdown">
<li><a class="dropdown-item" href="#">Action</a></li>
</ul>
</div>
<script>
const dropdownEl = document.getElementById('myDropdown')
const dropdown = new bootstrap.Dropdown(dropdownEl, {
// options
offset: '10,0',
autoClose: true, // true | 'inside' | 'outside' | false
boundary: 'clippingParents'
})
// methods
dropdown.show()
dropdown.hide()
dropdown.toggle()
// events
dropdownEl.addEventListener('show.bs.dropdown', () => {
console.log('about to show')
})
dropdownEl.addEventListener('shown.bs.dropdown', () => {
console.log('fully shown')
})
dropdownEl.addEventListener('hidden.bs.dropdown', () => {
console.log('fully hidden')
})
</script>Botones dropdown divididos
Los botones dropdown divididos separan la acción (botón izquierdo) de la apertura del menú (botón pequeño de flecha). dropdown-toggle-split reduce el padding del botón de apertura a una flecha estrecha. El texto visually-hidden ('Toggle Dropdown') garantiza la accesibilidad para lectores de pantalla. Los dos botones comparten la misma clase de color. Los botones divididos son ideales para 'Guardar' (acción principal) + menú (Guardar como, Exportar, etc.). Funcionan con los distintos tamaños (btn-lg/sm) y direcciones (dropup, dropend).
<!-- split button dropdown -->
<div class="btn-group">
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-primary dropdown-toggle dropdown-toggle-split"
data-bs-toggle="dropdown" aria-expanded="false">
<span class="visually-hidden">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another</a></li>
</ul>
</div>
<!-- split with different sizes -->
<div class="btn-group">
<button class="btn btn-success btn-lg">Large</button>
<button class="btn btn-success btn-lg dropdown-toggle dropdown-toggle-split"
data-bs-toggle="dropdown">
<span class="visually-hidden">Toggle</span>
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- dropup split -->
<div class="btn-group dropup">
<button class="btn btn-secondary">Dropup</button>
<button class="btn btn-secondary dropdown-toggle dropdown-toggle-split"
data-bs-toggle="dropdown">
<span class="visually-hidden">Toggle</span>
</button>
<ul class="dropdown-menu">...</ul>
</div>Collapse 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.
<!-- 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.
<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.
<!-- 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.
<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.
<!-- 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>Carrusel
Carrusel básico
Los carruseles ciclan contenido (imágenes, texto o personalizado). Estructura: carousel > carousel-inner > carousel-item. El primer ítem necesita la clase 'active'. carousel-control-prev/next con data-bs-slide='prev'/'next' dan navegación (data-bs-target debe apuntar al id del carrusel). d-block w-100 en las imágenes hace que se muestren correctamente. data-bs-ride='carousel' activa la reproducción automática al cargar. El texto visually-hidden en los controles es para la accesibilidad de lectores de pantalla.
<div id="carouselExample" class="carousel slide" data-bs-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="slide1.jpg" class="d-block w-100" alt="Slide 1">
</div>
<div class="carousel-item">
<img src="slide2.jpg" class="d-block w-100" alt="Slide 2">
</div>
<div class="carousel-item">
<img src="slide3.jpg" class="d-block w-100" alt="Slide 3">
</div>
</div>
<!-- previous/next controls -->
<button class="carousel-control-prev" type="button"
data-bs-target="#carouselExample" data-bs-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="visually-hidden">Previous</span>
</button>
<button class="carousel-control-next" type="button"
data-bs-target="#carouselExample" data-bs-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="visually-hidden">Next</span>
</button>
</div>Carrusel con indicadores
carousel-indicators añade puntos clicables abajo — uno por diapositiva. data-bs-slide-to='0' salta a ese índice de diapositiva. El indicador activo recibe la clase 'active' y aria-current='true'. Los indicadores permiten saltar directamente a una diapositiva sin ciclar. Incluye siempre indicadores en carruseles con más de 2-3 diapositivas — dan contexto de navegación (en qué diapositiva estoy, cuántas hay). Emparéjalos con los controles prev/next para una navegación completa.
<div id="carouselIndicators" class="carousel slide" data-bs-ride="carousel">
<!-- indicators (dots) -->
<div class="carousel-indicators">
<button type="button" data-bs-target="#carouselIndicators"
data-bs-slide-to="0" class="active" aria-current="true"
aria-label="Slide 1"></button>
<button type="button" data-bs-target="#carouselIndicators"
data-bs-slide-to="1" aria-label="Slide 2"></button>
<button type="button" data-bs-target="#carouselIndicators"
data-bs-slide-to="2" aria-label="Slide 3"></button>
</div>
<div class="carousel-inner">
<div class="carousel-item active">
<img src="1.jpg" class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="2.jpg" class="d-block w-100" alt="...">
</div>
</div>
<!-- controls (same as basic) -->
<button class="carousel-control-prev" data-bs-target="#carouselIndicators"
data-bs-slide="prev">...</button>
<button class="carousel-control-next" data-bs-target="#carouselIndicators"
data-bs-slide="next">...</button>
</div>Carrusel con captions
carousel-caption superpone texto en las diapositivas — genial para secciones hero. d-none d-md-block oculta los captions en móvil (donde se solaparían con imágenes pequeñas) y los muestra en md+. Los captions pueden incluir encabezados, párrafos y botones. Para legibilidad sobre imágenes, añade una capa de degradado bajo el caption (similar al patrón de overlay de imagen). Los captions del carrusel son la forma estándar de convertir carruseles de imágenes en secciones hero de marketing con CTAs.
<div id="carouselCaptions" class="carousel slide" data-bs-ride="carousel">
<div class="carousel-indicators">
<button data-bs-target="#carouselCaptions" data-bs-slide-to="0"
class="active" aria-current="true"></button>
<button data-bs-target="#carouselCaptions" data-bs-slide-to="1"></button>
</div>
<div class="carousel-inner">
<div class="carousel-item active">
<img src="hero1.jpg" class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>First slide label</h5>
<p>Some representative placeholder content.</p>
<a href="#" class="btn btn-primary">Learn more</a>
</div>
</div>
<div class="carousel-item">
<img src="hero2.jpg" class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>Second slide label</h5>
<p>Content for second slide.</p>
</div>
</div>
</div>
</div>Opciones del carrusel y crossfade
carousel-fade reemplaza la transición de deslizamiento por un fundido cruzado. carousel-dark usa controles/indicadores oscuros (para imágenes claras). Opciones: interval (ms entre diapositivas automáticas), pause ('hover' pausa al pasar el ratón), wrap (bucle), touch (soporte de deslizamiento). Funciones JS: cycle(), pause(), next(), prev(), to(n). Eventos: slide.bs.carousel (al dispararse) y slid.bs.carousel (terminado) dan los índices from/to para animaciones personalizadas o analítica.
<!-- crossfade transition -->
<div id="carouselFade" class="carousel slide carousel-fade" data-bs-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="1.jpg" class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="2.jpg" class="d-block w-100" alt="...">
</div>
</div>
</div>
<!-- dark variant (for light images) -->
<div class="carousel carousel-dark slide" data-bs-ride="carousel">
<!-- controls and indicators are dark -->
</div>
<!-- via JavaScript with options -->
<script>
const carousel = new bootstrap.Carousel(document.getElementById('myCarousel'), {
interval: 5000, // auto-play every 5s
keyboard: true, // arrow keys navigate
pause: 'hover', // pause on mouse hover
ride: 'carousel', // auto-start
wrap: true, // loop back to first slide
touch: true // swipe on touch devices
})
carousel.cycle() // start auto-play
carousel.pause() // pause
carousel.next() // next slide
carousel.prev() // previous slide
carousel.to(2) // jump to slide 2
</script>Carrusel táctil y responsivo
El deslizamiento táctil está activado por defecto (data-bs-touch='true'). Para carruseles responsivos con imágenes distintas por breakpoint, apila dos imgs con d-block d-md-none (móvil) y d-none d-md-block (escritorio) en el mismo carousel-item — solo se muestra una a la vez. data-bs-ride='false' desactiva la reproducción automática (solo navegación manual). data-bs-pause='hover' pausa al pasar el ratón — considéralo para contenido que el usuario necesita leer. Prueba siempre los carruseles en dispositivos táctiles para verificar el comportamiento de deslizamiento.
<!-- touch swipe enabled (default) -->
<div id="carouselTouch" class="carousel slide" data-bs-ride="carousel"
data-bs-touch="true" data-bs-interval="5000">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="1.jpg" class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="2.jpg" class="d-block w-100" alt="...">
</div>
</div>
</div>
<!-- different image sizes per breakpoint -->
<div class="carousel slide" data-bs-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<!-- mobile image -->
<img src="mobile.jpg"
class="d-block w-100 d-md-none" alt="...">
<!-- desktop image -->
<img src="desktop.jpg"
class="d-none d-md-block w-100" alt="...">
</div>
</div>
</div>
<!-- disable auto-play -->
<div class="carousel slide" data-bs-ride="false">
<!-- only moves via controls -->
</div>
<!-- pause on hover -->
<div class="carousel slide" data-bs-ride="carousel" data-bs-pause="hover">
<!-- pauses when mouse is over -->
</div>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 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- visible focus (don't remove outlines!) -->
<!-- Bootstrap provides focus-visible styling -->
<button class="btn btn-primary">Has visible focus ring</button>
<!-- skip link (first focusable element) -->
<body>
<a href="#main" class="visually-hidden-focusable">Skip to content</a>
<nav>...</nav>
<main id="main">...</main>
</body>
<!-- focus management for modals -->
<script>
const modal = document.getElementById('myModal')
modal.addEventListener('shown.bs.modal', () => {
// focus first input in modal
modal.querySelector('input')?.focus()
})
modal.addEventListener('hidden.bs.modal', () => {
// return focus to trigger
document.getElementById('openModalBtn').focus()
})
</script>
<!-- keyboard navigation for custom widgets -->
<div role="tablist">
<button role="tab" tabindex="0">Tab 1</button>
<button role="tab" tabindex="-1">Tab 2</button>
</div>
<script>
// arrow key navigation
document.querySelectorAll('[role="tab"]').forEach((tab, i, tabs) => {
tab.addEventListener('keydown', (e) => {
if (e.key === 'ArrowRight') tabs[(i + 1) % tabs.length].focus()
if (e.key === 'ArrowLeft') tabs[(i - 1 + tabs.length) % tabs.length].focus()
})
})
</script>List group
List group básico
list-group 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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.
<!-- 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>Fragmentos de Bootstrap relacionados
Copy-paste ready code for common tasks.
Grid System
Lay out pages with the 12-column responsive grid.
Responsive Utilities
Show, hide, and reorder elements per breakpoint.
Navbar
Build a responsive collapsing navbar with brand and links.
Cards
Compose a card with image, body, list, and footer.
Modal
Trigger and structure a Bootstrap modal dialog.
Forms & Validation
Build a responsive form with validation feedback.
Buttons
Use button variants, sizes, states, and groups.
Alerts
Display contextual messages with dismissible alerts.
Was this helpful?