Démarrage
Inclure Bootstrap
Incluez Bootstrap via un CDN pour un démarrage rapide — le CSS va dans le <head>, le bundle JS (qui inclut Popper) avant </body>. Le bundle.min.js inclut Popper pour les tooltips/dropdowns/popovers. Avec npm, importez le CSS et le JS dans votre fichier d'entrée. Bootstrap 5 a abandonné la dépendance jQuery — tous les composants fonctionnent en 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 JSConteneurs
Les conteneurs sont l'élément de mise en page le plus basique — ils centrent le contenu et ajoutent du padding horizontal. .container est de largeur fixe à chaque breakpoint (le max-width change) ; .container-fluid fait toujours 100%. Les conteneurs responsifs (container-sm/md/lg/xl/xxl) font 100% jusqu'au breakpoint nommé, puis deviennent à largeur fixe. Employez .container pour la plupart des mises en page ; .container-fluid pour les apps pleine largeur.
<!-- 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 responsifs
Bootstrap emploie un système de media queries mobile-first en min-width. Il y a 6 breakpoints : xs (défaut), sm (576px), md (768px), lg (992px), xl (1200px), xxl (1400px). Les classes comme col-md-6 s'appliquent à md ET au-delà. Pour montrer/masquer aux breakpoints, employez d-none (display:none) et d-{breakpoint}-block. Cette approche mobile-first signifie que vous stylez d'abord pour petits écrans, puis ajoutez de la complexité pour les plus grands.
/* 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 et styles de base
Reboot est le reset CSS de Bootstrap — il normalise les styles des navigateurs en unités rem (root em, basées sur la taille de police html de 16px). Tous les éléments reçoivent box-sizing: border-box. Titres, paragraphes, listes, tableaux et liens reçoivent des défauts sensés. Reboot retire les marges hautes des titres et listes, les réglant à 0. Cela donne une base cohérente entre navigateurs avant que les composants Bootstrap se superposent.
<!-- 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>Personnalisation par variables CSS
Bootstrap 5 expose des centaines de propriétés CSS personnalisées (variables) préfixées --bs-. Surchargez-les dans :root pour thèmer votre site globalement. Le mode sombre est intégré via data-bs-theme='dark' sur l'élément <html>, qui échange un jeu de variables. Cela rend le theming bien plus simple que l'ancienne approche des variables Sass — vous changez couleurs, polices, espacements et rayons en CSS pur, sans étape 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>Bases de mise en page
Lignes et colonnes
.row est un conteneur flex (display: flex) avec des marges horizontales négatives pour compenser le padding des colonnes. Les enfants .col directs se répartissent également pour remplir la ligne. Précisez col-{1-12} pour des proportions fixes (sur 12). Sans nombre, .col prend l'espace restant à parts égales. La grille à 12 colonnes est le cœur des mises en page Bootstrap — combinez col-{n} et .col auto pour des dispositions 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>Gouttières (espacement entre colonnes)
Les gouttières sont le padding entre colonnes, contrôlé par les classes g-* (g-0 à g-5). g-0 retire toutes les gouttières (colonnes bord à bord). g-3 est le défaut. Les gouttières agissent horizontalement (entre colonnes) et verticalement (entre lignes quand les colonnes passent à la ligne). Employez les variantes responsives (g-2 g-md-4) pour un espacement différent aux breakpoints. Le système de gouttières a remplacé l'ancienne approche à padding horizontal seul.
<!-- 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>Retour à la ligne et alignement des colonnes
Les colonnes passent à une nouvelle ligne quand leur total dépasse 12. Contrôlez l'alignement vertical avec align-items-* sur la ligne (start/center/end). Contrôlez la distribution horizontale avec justify-content-* (start/center/end/between/around/evenly). Tout repose sur flexbox sous le capot. Le retour à la ligne est automatique — pas besoin de sauts de ligne explicites. Cela rend les mises en page façon masonry faciles avec de simples classes col-*.
<!-- columns wrap when they exceed 12 total -->
<div class="row">
<div class="col-9">9 cols</div>
<div class="col-4">4 cols → wraps to next line (9+4=13)</div>
<div class="col-6">6 cols (new line)</div>
</div>
<!-- vertical alignment -->
<div class="row align-items-center">
<div class="col">Vertically centered</div>
</div>
<!-- options: align-items-start, -center, -end -->
<div class="row align-items-end">...</div>
<!-- horizontal alignment -->
<div class="row justify-content-center">
<div class="col-6">Centered horizontally</div>
</div>
<!-- options: justify-content-start, -center, -end, -between, -around, -evenly -->Ordre des colonnes
Les classes order réordonnent visuellement les colonnes sans changer le HTML. order-first, order-{1-5}, order-last offrent 7 niveaux. Employez les variantes responsives (order-md-first) pour changer l'ordre aux breakpoints — utile pour le SEO (contenu important d'abord dans le HTML) tout en l'affichant différemment sur mobile. Les offsets (offset-md-4) ajoutent une marge gauche pour pousser les colonnes à droite — utile pour centrer ou indenter. Les deux s'appuient sur l'ordre flexbox et les utilitaires de marge.
<!-- 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 et empilement
Bootstrap emploie une échelle z-index pour l'empilement : z-1, z-2, z-3 (et les négatifs z-n0, z-n1, z-n2). Les composants comme modales, dropdowns et tooltips ont des z-index intégrés plus élevés (1000-1080). Pour que z-index fonctionne, l'élément doit être positionné (relative, absolute, fixed ou sticky). Évitez les valeurs de z-index arbitraires — employez l'échelle de Bootstrap pour la cohérence. L'ordre d'empilement est conçu pour que les modales apparaissent toujours au-dessus des dropdowns, eux-mêmes au-dessus des 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>Système de grille
Grille de base
La grille de Bootstrap est un système à 12 colonnes. col-{1-12} précise combien des 12 colonnes un élément couvre. col-12 = pleine largeur, col-6 = moitié, col-4 = tiers, col-3 = quart. Les colonnes d'une ligne devraient sommer à 12 (ou moins — l'espace restant se distribue). Sans nombre, .col divise l'espace restant également. La grille emploie flexbox — les lignes sont des conteneurs flex, les colonnes des items 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>Colonnes responsives
Les classes de colonnes responsives (col-sm-*, col-md-*, col-lg-*, col-xl-*, col-xxl-*) s'appliquent à ce breakpoint ET au-delà (mobile-first). La plus petite classe applicable gagne. col-12 col-md-6 col-lg-4 signifie : pleine largeur sur mobile, moitié sur tablette, tiers sur desktop. row-cols-* fixe le nombre de colonnes de même largeur par ligne à un breakpoint — plus simple que de préciser col-* sur chaque enfant quand toutes les colonnes sont égales.
<!-- 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>Colonnes imbriquées
Pour imbriquer des grilles, mettez un .row dans un .col — la ligne imbriquée crée un nouveau contexte à 12 colonnes dans la largeur de la colonne parente. Les colonnes imbriquées (col-4, col-8) divisent la largeur du parent, pas celle de la page entière. L'imbrication est essentielle pour les mises en page complexes comme des barres latérales avec sous-sections. Gardez une imbrication peu profonde (2-3 niveaux max) pour éviter des colonnes trop étroites et préserver la lisibilité.
<!-- 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 et marges de colonnes
offset-{breakpoint}-{n} ajoute n colonnes de marge gauche, utile pour centrer ou indenter. offset-md-4 sur un col-md-4 le centre (4 + 4 + 4 = 12). Pour un centrage plus simple, employez mx-auto (margin: 0 auto) qui fonctionne quel que soit le compte de colonnes. Les offsets responsives (offset-sm-2 offset-md-0) permettent d'indenter sur mobile mais pas sur desktop. Les offsets sont plus propres que des colonnes de remplissage vides.
<!-- 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 et disposition auto
row-cols-{n} fixe combien de colonnes de même largeur par ligne — bien plus propre que d'ajouter col-* à chaque enfant quand ils ont tous la même largeur. row-cols-2 signifie 2 colonnes par ligne ; les items passent à la ligne automatiquement. Les variantes responsives (row-cols-1 row-cols-md-3) changent le compte aux breakpoints. Un .col simple (sans nombre) fait diviser l'espace également. Employez row-cols pour les grilles de cartes ; col-{n} quand les colonnes exigent des proportions précises.
<!-- 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 -->Typographie
Titres et display
Bootstrap style h1-h6 avec des tailles en rem (h1 = 2.5rem, h6 = 1rem). Les classes .h1-.h6 appliquent le style de titre à tout élément. Les titres display (display-1 à display-6) sont plus grands et plus fins — pour les sections vedettes. .lead rend un paragraphe légèrement plus grand et plus clair — typiquement le premier paragraphe. Les titres n'ont pas de marge haute par défaut (Reboot la retire) pour éviter les trous de mise en page.
<!-- 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>Éléments de texte en ligne
Bootstrap style les éléments HTML sémantiques : <mark> (surlignage), <del>/<s> (barré), <ins>/<u> (souligné), <small> (petits caractères). Les utilitaires de texte apportent le style : text-uppercase/lowercase/capitalize, fw-bold/light/normal, fst-italic, text-muted (gris). text-decoration-underline/line-through contrôlent les soulignements. Ces utilitaires sont préférés aux styles inline pour la cohérence.
<!-- 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>Listes
list-unstyled retire le style par défaut des listes (puces et padding gauche) — utile pour les menus de navigation. list-inline rend les items de liste en ligne (pour nuages de tags, fils d'Ariane). Les listes de description (dl/dt/dd) obtiennent une disposition horizontale avec la classe row — dt à gauche, dd à droite, alignés via la grille. Les listes dans Bootstrap ont margin-top: 0 et margin-bottom: 1rem pour un espacement cohérent.
<!-- unordered list -->
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
<!-- unstyled list (no bullets, no padding) -->
<ul class="list-unstyled">
<li>No bullets</li>
<li>No left padding</li>
</ul>
<!-- inline list -->
<ul class="list-inline">
<li class="list-inline-item">Inline 1</li>
<li class="list-inline-item">Inline 2</li>
<li class="list-inline-item">Inline 3</li>
</ul>
<!-- description list -->
<dl>
<dt>Term</dt>
<dd>Definition</dd>
</dl>
<!-- horizontal description list -->
<dl class="row">
<dt class="col-sm-3">Term</dt>
<dd class="col-sm-9">Definition</dd>
</dl>Blockquotes et code
Les blockquotes emploient la structure <figure>/<blockquote>/<figcaption> pour la sémantique. blockquote-footer style la citation. Style du code : <code> pour le code en ligne, <pre><code> pour les blocs de code, <kbd> pour les touches clavier, <var> pour les variables. Échappez toujours les chevrons en HTML dans le code (< pour <). Les blockquotes peuvent s'aligner avec text-center/text-end. Le style kbd donne aux touches une apparence de clavier.
<!-- 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>Alignement et retour du texte
Alignement du texte : text-start/center/end (Bootstrap 5 a renommé left/right en start/end pour le support RTL). Les variantes responsives (text-md-start) changent l'alignement aux breakpoints. text-nowrap empêche le retour ; text-truncate ajoute des points de suspension en cas de débordement (exige une max-width ou un conteneur contraint). text-break casse les mots longs. lh-* contrôle la hauteur de ligne. Ces utilitaires gèrent le flux du texte sans CSS personnalisé.
<!-- 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>Tableaux
Tableau de base
La classe .table ajoute padding, bordures et séparateurs horizontaux. Employez <thead> pour les en-têtes, <tbody> pour les données. scope='col' sur les <th> de l'en-tête et scope='row' sur les <th> des lignes améliore l'accessibilité pour les lecteurs d'écran. Les tableaux sont opt-in — sans .table, vous obtenez des tableaux HTML sans style. Employez toujours les éléments sémantiques de tableau (thead, tbody, th, tr, td) pour l'accessibilité.
<!-- 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 de tableau et zébrage
Modificateurs de tableau : table-striped (couleurs alternées des lignes), table-bordered (toutes bordures), table-borderless (aucune bordure), table-hover (surlignage de ligne au survol), table-sm (padding condensé), table-dark (thème sombre). Ils se combinent : table table-striped table-hover. La variante dark inverse les couleurs pour les fonds sombres. table-sm réduit de moitié le padding des cellules pour un affichage de données plus dense.
<!-- 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>Couleurs de tableau
Appliquez les classes contextuelles aux <tr> ou <td> : table-primary, table-success, table-danger, table-warning, table-info, table-secondary, table-light, table-dark, table-active. Elles ajoutent des teintes de fond subtiles pour l'indication de statut. Sur les tableaux sombres, les mêmes classes donnent des variantes plus claires. Employez-les avec parcimonie pour un statut significatif (success pour terminé, danger pour erreurs) plutôt que pour la décoration.
<!-- 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>Tableaux responsifs
Enveloppez les tableaux dans .table-responsive pour activer le défilement horizontal sur petits écrans (prévient la casse de la mise en page). table-responsive-sm/md/lg/xl/xxl ne défile qu'en dessous de ce breakpoint — le tableau tient normalement sur les écrans plus grands. Sans enveloppe responsif, les tableaux larges débordent de leur conteneur. La div enveloppe est nécessaire car overflow ne peut s'appliquer directement à <table>. Employez-la toujours pour les tableaux à beaucoup de colonnes.
<!-- 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>Groupes et légendes de tableau
caption-top déplace la légende au-dessus du tableau (défaut en dessous). Les légendes améliorent l'accessibilité pour les lecteurs d'écran. Stylez thead/tbody/tfoot séparément avec table-light/table-dark. Alignement vertical : align-top, align-middle, align-bottom sur cellules ou lignes — utile quand les cellules ont des hauteurs de contenu différentes. L'élément tfoot est stylé comme le thead par défaut mais peut se personnaliser.
<!-- 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>Formulaires
Contrôles de formulaire
form-control style les inputs texte, textareas et inputs de fichiers. form-select style les menus déroulants. Associez toujours les inputs à des éléments <label> (avec for/id correspondants) pour l'accessibilité. form-label ajoute l'espacement approprié. disabled empêche l'interaction ; readonly montre la valeur sans édition. mb-3 (margin-bottom) ajoute l'espacement entre groupes de formulaire. La classe .form-control applique hauteur, padding et styles de focus cohérents.
<!-- 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>Grille et disposition de formulaire
Employez le système de grille (row/col) pour disposer les formulaires. Pour les formulaires horizontaux, associez col-form-label avec col-* pour l'alignement label/input. row-cols-lg-auto fait que les éléments de formulaire se dimensionnent sur leur contenu (formulaire en ligne) sur grands écrans. align-items-center aligne verticalement labels et inputs. La grille donne un contrôle précis de la disposition du formulaire aux différents breakpoints sans CSS personnalisé.
<!-- 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>Groupes d'input
Les input groups préfixent ou suffixent du texte/boutons aux inputs via input-group-text. Courant pour les @ d'utilisateurs, $ de devise, .00 de décimales ou boutons de recherche. L'enveloppe input-group fait paraître l'addon et l'input comme un seul contrôle connecté. Plusieurs inputs peuvent partager un addon. Les boutons dans les input groups emploient btn-outline-* pour un look connecté. Ne mélangez pas les input groups avec 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>Labels flottants
Les labels flottants animent le label de l'intérieur de l'input vers le dessus quand le champ est focalisé ou a du contenu. Le label doit venir APRÈS l'input en HTML. Un attribut placeholder est requis (même vide) pour le comportement flottant. Ce pattern économise l'espace et paraît moderne. Ne combinez pas avec input-group. Les labels flottants fonctionnent avec inputs, textareas et selects. Une alternative propre aux labels traditionnels pour les formulaires compacts.
<!-- 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 -->Validation
Bootstrap fournit les classes is-valid et is-invalid pour le style de validation, avec valid-feedback et invalid-feedback pour les messages. La classe needs-validation sur un formulaire, combinée à novalidate (désactive les bulles du navigateur), permet d'employer l'UI de validation de Bootstrap avec un JS personnalisé. À l'envoi, ajoutez was-validated pour montrer tous les états de validation. Cela fonctionne avec les contraintes HTML5 (required, pattern, type) ou une validation serveur personnalisée.
<!-- 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 -->Cartes
Carte de base
Les cartes sont des conteneurs flexibles avec header, body et footer optionnels. card-img-top place une image en haut. card-title, card-subtitle, card-text stylent le contenu. La largeur se contrôle par la grille parente ou un attribut style — les cartes valent pleine largeur par défaut. card-header et card-footer servent au contenu structuré. Les cartes ont remplacé les panels, wells et thumbnails de Bootstrap 3 par un composant unifié.
<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>Types de contenu de carte
Les cartes peuvent porter divers types de contenu : images, texte, list groups (employez list-group-flush pour retirer les bordures et épouser les bords de la carte), et liens (card-link ajoute l'espacement). Mélangez les sections — card-body, list-group, card-header, card-footer — pour bâtir exactement la carte voulue. list-group-flush intègre les listes sans couture dans les cartes sans doubles bordures. Cette flexibilité fait des cartes le composant le plus polyvalent 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>Grille et groupes de cartes
card-group connecte des cartes avec bordures partagées et hauteurs égales. Pour des grilles de cartes responsives, employez le système de grille : row row-cols-1 row-cols-md-3 g-4 donne 1 colonne sur mobile, 3 sur desktop, avec un espacement gap-4. Chaque carte va dans un .col. L'approche grille est plus flexible que card-group — les cartes peuvent avoir des hauteurs indépendantes et vous contrôlez le retour à la ligne. Employez card-group seulement pour des cartes connectées de même hauteur.
<!-- 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>Navigation de carte
Ajoutez de la navigation aux cartes avec nav-tabs ou nav-pills dans le card-header. card-header-tabs et card-header-pills intègrent la nav au ras des bords de l'en-tête. Employez nav-link active pour l'onglet courant, nav-link disabled pour l'inactif. Pour rendre les onglets fonctionnels (changer le contenu), ajoutez data-bs-toggle='tab' et des tab panes — le JS de Bootstrap gère le basculement. Ce pattern est courant pour les dashboards et cartes de contenu à plusieurs vues.
<!-- 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 et overlay de carte
Variantes de couleur de carte : bg-{couleur} avec text-white/text-dark pour des fonds pleins ; border-{couleur} avec text-{couleur} pour des bordures colorées. card-img-overlay place du texte sur une image (card-img remplit la carte, le contenu overlay se pose dessus) — employez text-bg-dark pour du texte lisible sur les images. text-center/text-start/text-end contrôlent l'alignement du texte. Pour les overlays d'images sombres, assurez un contraste suffisant entre texte et image.
<!-- 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>Modales
Modale de base
Les modales se déclenchent par data-bs-toggle='modal' avec data-bs-target correspondant à l'id de la modale. Structure : modal > modal-dialog > modal-content > modal-header/body/footer. btn-close est le bouton X (data-bs-dismiss='modal'). fade ajoute une transition. tabindex='-1' et aria-hidden servent à l'accessibilité. La modale est cachée par défaut et positionnée en fixed. Le JS de Bootstrap gère l'affichage, le masquage, le fond et la gestion du focus.
<!-- 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>Taille et défilement des modales
Tailles de modale : modal-sm, défaut, modal-lg, modal-xl, modal-fullscreen. modal-fullscreen-{breakpoint}-down est plein écran seulement en dessous de ce breakpoint. modal-dialog-scrollable fait défiler le body (header/footer restent fixes) — essentiel pour du contenu long. modal-dialog-centered centre la modale verticalement. Ces classes se posent sur modal-dialog. Combinez-les : modal-dialog modal-dialog-centered modal-dialog-scrollable pour une modale centrée et défilable.
<!-- 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>Modale via JavaScript
Contrôlez les modales via JS : créez une instance avec new bootstrap.Modal(el), puis show()/hide()/toggle(). backdrop: 'static' empêche la fermeture au clic sur le fond ; keyboard: false désactive Échap. Événements : show.bs.modal, shown.bs.modal, hide.bs.modal, hidden.bs.modal (show = démarrage, shown = fini). Employez shown.bs.modal pour focaliser un input ou charger du contenu dynamique. Le fond statique est utile pour les formulaires où une fermeture accidentelle perdrait les données.
<!-- 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 et popovers
Les tooltips s'affichent au survol/focus ; les popovers au clic. Les deux exigent une initialisation JS (Bootstrap ne s'initialise pas tout seul pour la performance). data-bs-placement règle la position (top/bottom/left/right). Les popovers ont title + content ; data-bs-html='true' autorise le HTML. data-bs-trigger='focus' rend les popovers fermables (clic dehors). Tooltips et popovers emploient Popper.js (inclus au bundle) pour un positionnement intelligent. Idéals pour indications, définitions et infos contextuelles.
<!-- 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 (tiroir)
Offcanvas est un tiroir coulissant (comme une modale mais depuis le bord). offcanvas-start/end/top/bottom règle le sens de glissement. La structure reflète la modale : offcanvas-header/body avec btn-close. data-bs-backdrop='static' empêche la fermeture au clic sur le fond. text-bg-dark pour la variante sombre. Offcanvas est idéal pour la navigation mobile, les filtres ou les panneaux latéraux. Contrairement aux modales, il ne couvre pas tout l'écran — c'est un tiroir en overlay. Remplacez navbar-collapse par offcanvas pour des menus mobiles modernes.
<!-- 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>Alertes
Alertes de base
Les alertes affichent des messages de retour contextuels. alert-{variante} règle la couleur (primary, success, danger, warning, info, light, dark). role='alert' sert à l'accessibilité des lecteurs d'écran. alert-link style les liens pour suivre la couleur de l'alerte. Employez les alertes pour : le retour de validation de formulaire, les résultats d'action (enregistré ! supprimé !) ou les avis importants. Choisissez les couleurs sémantiquement : success pour positif, danger pour erreurs, warning pour prudence, info pour info neutre.
<!-- 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>Alertes fermables
alert-dismissible ajoute le padding pour le bouton de fermeture ; btn-close avec data-bs-dismiss='alert' le ferme. fade show active la transition de fondu. Une fois fermée, l'alerte est retirée du DOM (pas seulement cachée). Via JS, créez une instance Alert et appelez close(). L'événement closed.bs.alert se déclenche après le retrait. Pour la montrer à nouveau, il faut recréer l'élément DOM. Pour des fermetures persistantes (ne plus montrer), stockez l'état 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>Alertes avec icônes et contenu
Les alertes peuvent porter du contenu riche : titres (alert-heading), paragraphes, séparateurs (hr), icônes et boutons d'action. Pour les icônes, employez Bootstrap Icons (classe bi) ou des SVG avec alignement flex. d-flex align-items-center centre verticalement icône et texte. Incluez des boutons d'action (comme « Prolonger » pour les avertissements de session) à côté du bouton de fermeture. Les alertes ne servent pas qu'au texte — ce sont des conteneurs flexibles pour un retour important et fermable.
<!-- 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>Notifications toast
Les toasts sont des notifications légères (comme les toasts Android). Elles se masquent seules après un délai (défaut 5 s). Enveloppez dans toast-container pour l'empilement. position-fixed avec top-0 end-0 épingle en haut à droite. aria-live='assertive' annonce aux lecteurs d'écran. toast-header porte icône, titre, horodatage, bouton de fermeture ; toast-body le message. Contrairement aux alertes, les toasts ne bloquent pas l'UI — non intrusifs. Employez-les pour « Enregistré ! », « Nouveau message » ou la fin de tâches d'arrière-plan.
<!-- 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>Région d'alerte en direct
Pour des alertes mises à jour dynamiquement (messages de statut, progression), employez aria-live='polite' — les lecteurs d'écran annoncent les changements sans interrompre. aria-live='assertive' annonce immédiatement (pour les erreurs critiques). aria-atomic='true' lit tout le contenu au changement (pas seulement la partie changée). role='alert' est implicitement assertive. Ce pattern d'accessibilité garantit que les utilisateurs de lecteurs d'écran entendent les mises à jour dynamiques. Combinez avec les classes d'alerte pour le style visuel.
<!-- 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 de base
Les badges sont de petits indicateurs de compte/label. bg-{couleur} règle le fond ; ajoutez text-dark sur les fonds clairs (warning, info, light) pour le contraste. Les badges s'échellent relativement à la taille de police de leur élément parent — un badge dans un h1 est plus grand que dans un p. Employez les badges pour : comptes non lus, labels de statut, tags « Nouveau », numéros de version. Ce sont des éléments inline qui s'insèrent dans le flux de texte.
<!-- 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 pastille et arrondis
rounded-pill fait des badges entièrement arrondis (forme pastille). rounded-0 à rounded-3 contrôlent l'échelle de border-radius. rounded-circle avec padding crée des badges circulaires — utile pour les comptes de notifications. Pour des cercles parfaits à un chiffre, réglez width/height égaux et employez d-flex align-items-center justify-content-center. Les badges pastille sont courants pour les tags et indicateurs de statut.
<!-- 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 dans boutons et nav
Badges dans les boutons : position-relative sur le bouton, position-absolute sur le badge avec top-0 start-100 translate-middle pour le placer au coin haut-droit. Du texte visually-hidden dans le badge fournit le contexte aux lecteurs d'écran. Les badges dans les liens de nav et items de liste montrent des comptes — employez justify-content-between pour les pousser à droite. Le pattern « 99+ » est courant quand les comptes dépassent les limites d'affichage.
<!-- 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>Indicateurs de badge (point)
Les badges-points (pas de texte, juste un cercle coloré) indiquent un statut sans compte — comme « non lu » ou « en ligne ». Employez p-1 avec rounded-circle pour un petit point, border-light pour le détacher du fond. Positionnez avec la même technique translate-middle. Les points de statut en ligne (vert = en ligne, gris = hors ligne) vont au coin bas des avatars. Les badges peuvent aussi envelopper des icônes (Bootstrap Icons : bi bi-star-fill) avec du texte pour les notes.
<!-- 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 et grow
Les spinners indiquent l'état de chargement. spinner-border est un anneau tournant ; spinner-grow un cercle pulsant. text-* les colore. spinner-border-sm/grow-sm sont plus petits. Tailles personnalisées via width/height CSS. Incluez toujours role='status' avec du texte visually-hidden pour l'accessibilité. Dans les boutons, employez spinner-border-sm avec disabled pour montrer une action en cours. Les spinners sont en CSS pur (sans JS) — ils s'animent via bordure et transitions d'opacité.
<!-- 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>Progression et spinners
Barre de progression de base
Les barres de progression montrent l'avancement d'une tâche. Réglez la largeur en pourcentage via style inline. role='progressbar' avec aria-valuenow/min/max sert à l'accessibilité. La hauteur se règle sur le conteneur .progress (défaut 1rem). bg-{couleur} sur la barre change sa couleur. Le texte de label dans la barre est optionnel — omettez-le pour des barres minimales. Réglez toujours la largeur via style (pas une classe) puisque les valeurs sont dynamiques.
<!-- 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>Progression rayée et animée
progress-bar-striped ajoute des rayures diagonales. progress-bar-animated fait bouger les rayures (pour les tâches actives/en cours). N'employez l'animation que pour les tâches en cours — barres statiques pour les terminées. Mettez à jour la progression en JS en changeant style.width et aria-valuenow. L'animation emploie le CSS — pas de JS pour le mouvement. Combinez bg-* avec striped pour des barres rayées colorées.
<!-- 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>Plusieurs barres de progression
Plusieurs div progress-bar dans un même conteneur .progress s'empilent côte à côte — chacune prend son pourcentage de la largeur totale. Utile pour montrer une composition (ex. stockage : 25% photos, 30% vidéos, 20% apps). Les barres partagent la même hauteur et se jouxtent sans écart. Le total devrait idéalement sommer à 100% (ou moins si incomplet). Chacune peut avoir sa couleur et son label.
<!-- 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 -->Chargement par placeholders
Les placeholders (chargement squelette) montrent des blocs gris là où le contenu apparaîtra — mieux que les spinners pour les pages riches en contenu. placeholder-glow crée un scintillement pulsant ; placeholder-wave une vague mouvante. col-* règle la largeur de chaque bloc. Pour des cartes squelettes, employez placeholder dans les composants card avec aria-hidden='true'. Cela donne aux utilisateurs un aperçu de la mise en page avant le chargement des données, réduisant l'attente perçue.
<!-- placeholder (gray animated blocks) -->
<div class="placeholder-glow">
<span class="placeholder col-12"></span>
<span class="placeholder col-12"></span>
<span class="placeholder col-8"></span>
</div>
<!-- wave animation -->
<div class="placeholder-wave">
<span class="placeholder col-12"></span>
</div>
<!-- placeholder card (skeleton loading) -->
<div class="card" aria-hidden="true">
<div class="card-body">
<h5 class="card-title placeholder-glow">
<span class="placeholder col-6"></span>
</h5>
<p class="card-text placeholder-glow">
<span class="placeholder col-7"></span>
<span class="placeholder col-4"></span>
<span class="placeholder col-4"></span>
<span class="placeholder col-6"></span>
</p>
<a class="btn btn-primary disabled placeholder col-6"></a>
</div>
</div>Slider de plage
form-range style l'input range natif (slider). Réglez les attributs min, max et step pour la plage et l'incrément. Le slider est pleine largeur par défaut. Pour un affichage de valeur, employez oninput pour mettre à jour un label à mesure que l'utilisateur glisse. Disabled le grise. Les inputs range conviennent au volume, à l'opacité ou toute valeur continue où la précision exacte n'est pas nécessaire. Associez toujours un label pour l'accessibilité.
<!-- range input -->
<label for="customRange1" class="form-label">Example range</label>
<input type="range" class="form-range" id="customRange1" min="0" max="5" step="0.5">
<!-- with value display -->
<div class="d-flex">
<input type="range" class="form-range me-2" id="range"
min="0" max="100" oninput="document.getElementById('val').textContent = this.value">
<span id="val" class="badge bg-primary">50</span>
</div>
<!-- disabled -->
<input type="range" class="form-range" disabled>
<!-- min, max, step -->
<input type="range" class="form-range" min="-10" max="10" step="2" value="0">Classes utilitaires
Espacement (margin et padding)
Les utilitaires d'espacement suivent {propriété}{côtés}-{taille}. m = margin, p = padding. Côtés : t/b (haut/bas), s/e (début/fin — gauche/droite en LTR), x (gauche+droite), y (haut+bas), blanc (tous). Les tailles 0-5 correspondent à l'échelle d'espacement (0, 0.25rem, 0.5rem, 1rem, 1.5rem, 3rem). mx-auto centre les éléments bloc. Responsif : ajoutez le breakpoint (mt-md-3). Bootstrap 5 a renommé left/right en start/end pour le support 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>Couleurs et fonds
text-{couleur} règle la couleur du texte ; bg-{couleur} le fond. text-bg-{couleur} (Bootstrap 5.2+) règle automatiquement une couleur de texte contrastante pour le fond. bg-gradient ajoute un dégradé subtil. Opacité : text-opacity-50 ou bg-opacity-50 (10%, 25%, 50%, 75%, 100%). text-muted est gris (texte secondaire). Assurez toujours un contraste suffisant entre texte et fond — employez text-white sur les fonds sombres. Les couleurs portent un sens sémantique (success=vert, danger=rouge).
<!-- 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 et flexbox
d-* règle la propriété display (d-none masque les éléments). Les variantes responsives d-{breakpoint}-* changent le display aux breakpoints — d-none d-md-block masque sur mobile, montre sur desktop. d-flex active flexbox ; flex-direction, justify-content-*, align-items-* et flex-wrap contrôlent la disposition flex. Ces utilitaires remplacent la plupart du CSS personnalisé de mise en page. d-md-flex active flex seulement à md+. Combinez pour des mises en page responsives complexes sans media queries.
<!-- display utilities -->
<div class="d-none">display: none</div>
<div class="d-inline">display: inline</div>
<div class="d-inline-block">display: inline-block</div>
<div class="d-block">display: block</div>
<div class="d-flex">display: flex</div>
<div class="d-inline-flex">display: inline-flex</div>
<!-- responsive display -->
<div class="d-none d-md-block">Hidden on mobile, block on md+</div>
<div class="d-block d-md-none">Visible only below md</div>
<!-- flex direction -->
<div class="d-flex flex-column">Column</div>
<div class="d-flex flex-row-reverse">Reversed row</div>
<!-- justify content -->
<div class="d-flex justify-content-center">Center</div>
<div class="d-flex justify-content-between">Space between</div>
<div class="d-flex justify-content-around">Space around</div>
<!-- align items -->
<div class="d-flex align-items-center">Vertically centered</div>
<div class="d-flex align-items-end">Bottom aligned</div>
<!-- flex wrap -->
<div class="d-flex flex-wrap">Wrap</div>
<div class="d-flex flex-nowrap">No wrap</div>Position et floats
position-* règle la position CSS. position-sticky avec top-0 crée un en-tête épinglé (se colle au scroll). top/bottom/start/end (0 ou 50%) règlent les insets. translate-middle centre les éléments (combinez top-50 start-50 pour un centrage parfait). Les floats (float-start/end) sont un héritage — employez flexbox pour la mise en page. clearfix nettoie les enfants flottants. fixed-top/fixed-bottom épinglent les éléments à la fenêtre. Sticky est préféré à fixed pour les navbars car il ne chevauche pas le contenu au départ.
<!-- 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>Bordures, ombres et rayons
border ajoute/retire des bordures sur des côtés précis. border-{couleur} les colore ; border-{1-5} règle la largeur. rounded-* contrôle le border-radius : rounded-0 (aucun), rounded (défaut), rounded-3 (plus grand), rounded-pill (capsule), rounded-circle (50%). rounded-{côté} n'arrondit que des coins précis. shadow-* ajoute des ombres de boîte : none, sm, défaut, lg. Les ombres ajoutent de la profondeur — employez shadow-sm pour une élévation subtile, shadow-lg pour les modales/éléments flottants. Ces utilitaires gèrent la plupart du style visuel sans CSS personnalisé.
<!-- 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>Images et figures
Images responsives
img-fluid rend les images responsives (max-width: 100%, height: auto) — elles ne débordent jamais de leur conteneur. w-100 force la pleine largeur. figure/figure-img/figure-caption offrent l'image avec légende sémantique (mieux que div + p). float-start/end aligne les images ; mx-auto d-block centre. rounded ajoute des coins arrondis. Incluez toujours un texte alt pour l'accessibilité — décrivez l'image pour les lecteurs d'écran. Pour les images décoratives, employez 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>Formes et miniatures d'image
Formes d'image : rounded (coins arrondis), rounded-circle (circulaire — fonctionne mieux sur images carrées), rounded-pill (capsule). img-thumbnail ajoute bordure, padding et coins arrondis — look photo imprimée. Combinez img-thumbnail avec rounded-circle pour une miniature circulaire. Pour les avatars, réglez width/height explicites pour réserver l'espace et prévenir le décalage de mise en page. Les classes de forme fonctionnent sur tout élément, pas seulement les images — utiles pour les vignettes vidéo ou photos de profil.
<!-- rounded corners -->
<img src="..." class="rounded" alt="Rounded">
<!-- fully rounded (circle) -->
<img src="..." class="rounded-circle" alt="Circle">
<!-- thumbnail (border + padding) -->
<img src="..." class="img-thumbnail" alt="Thumbnail">
<!-- adds padding, border, rounded corners -->
<!-- pill shape -->
<img src="..." class="rounded-pill" alt="Pill">
<!-- combination: thumbnail + circle -->
<img src="..." class="img-thumbnail rounded-circle" alt="Circle thumb">
<!-- avatar sizes (set width/height) -->
<img src="avatar.jpg" class="rounded-circle" width="40" height="40" alt="Avatar">
<img src="avatar.jpg" class="rounded-circle" width="100" height="100" alt="Large avatar">Figure et légendes
figure est l'élément HTML sémantique des images avec légendes — meilleur pour l'accessibilité que les divs. figure-img style l'image (combinez avec img-fluid et rounded). figure-caption style le texte de légende (muted par défaut). text-start/center/end aligne la légende. Enveloppez l'image dans un <a> pour des agrandissements cliquables. Les figures sont le choix sémantique correct pour le contenu éditorial, la documentation et les galeries.
<!-- 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>Images de fond
Bootstrap n'a pas d'utilitaires background-image (les images dépendent du contenu), employez donc des styles inline. background-size: cover remplit le conteneur sans déformation ; background-position: centre le centre. Pour du texte sur images, ajoutez un overlay en dégradé (sombre en bas) pour la lisibilité. position-relative sur un enveloppeur avec des couches position-absolute permet d'empiler image, overlay et texte. C'est le pattern des sections vedettes et cartes d'images.
<!-- 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>Grille et galerie d'images
Les grilles d'images emploient le système standard row/col avec g-* pour les gouttières. Pour des images de même hauteur quel que soit le ratio, réglez un conteneur à hauteur fixe et employez object-fit: cover sur l'img avec w-100 h-100. row-cols-* crée des colonnes de même largeur sans préciser col-* sur chaque item. Pour du vrai masonry (hauteurs variables, sans trous), il faut des colonnes CSS ou des bibliothèques JS — la grille de Bootstrap ne fait pas de masonry nativement. img-fluid garantit que les images ne débordent jamais de leurs cellules de grille.
<!-- 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 de base
Les dropdowns exigent : un déclencheur (bouton ou ancre avec data-bs-toggle='dropdown') et un ul.dropdown-menu avec des éléments dropdown-item. Les items peuvent être <a> (pour la navigation) ou <button> (pour les actions). aria-expanded reflète l'état ouvert. Le dropdown se positionne sous le déclencheur par défaut (Popper.js gère le positionnement). Un clic dehors le ferme. Le bundle JS (avec Popper) est requis pour que les dropdowns fonctionnent.
<!-- 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>Contenu du menu dropdown
Les menus dropdown peuvent contenir : dropdown-header (titre de section), dropdown-divider (ligne de séparation), dropdown-item (liens/boutons), dropdown-item-text (texte non cliquable), items active/disabled. Formulaires dans les dropdowns : ajoutez le padding p-4 et employez la classe dropdown-menu sur le formulaire lui-même. Parfait pour des dropdowns de connexion ou formulaires de filtres. Groupez les items liés avec des headers et des dividers pour des menus balayables.
<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>Alignement des dropdowns
dropdown-menu-end aligne le menu à droite. dropdown-menu-{breakpoint}-end n'aligne à droite qu'à ce breakpoint. dropup/dropend/dropstart changent le sens d'ouverture (employez dropup pour les menus en bas de page). data-bs-offset='x,y' décale la position du menu. data-bs-auto-close='outside' garde le menu ouvert au clic intérieur (utile pour les dropdowns de formulaire). Ces options couvrent la plupart des besoins de positionnement sans CSS personnalisé.
<!-- default: aligned left below trigger -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Left-aligned
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- right-aligned menu -->
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Right-aligned
</button>
<ul class="dropdown-menu dropdown-menu-end">...</ul>
</div>
<!-- responsive alignment -->
<ul class="dropdown-menu dropdown-menu-lg-end">
<!-- left on mobile, right on lg+ -->
</ul>
<!-- dropup (menu opens above) -->
<div class="dropup">
<button class="btn btn-secondary dropdown-toggle" data-bs-toggle="dropdown">
Dropup
</button>
<ul class="dropdown-menu">...</ul>
</div>
<!-- dropend (right) / dropstart (left) -->
<div class="dropend">...</div>
<div class="dropstart">...</div>
<!-- menu offset -->
<button data-bs-toggle="dropdown" data-bs-offset="10,20">
Offset menu
</button>Dropdown via JavaScript
Contrôlez les dropdowns via JS : new bootstrap.Dropdown(el) crée une instance. show()/hide()/toggle() la contrôlent par programme. Options autoClose : true (défaut, ferme à tout clic), 'inside' (ferme seulement au clic d'item), 'outside' (ferme au clic extérieur), false (jamais de fermeture auto — manuelle seulement). Événements : show/shown/hide/hidden.bs.dropdown. Employez shown.bs.dropdown pour charger du contenu dynamique ou focaliser un item précis. Utile pour des dropdowns dynamiques pilotés par les données.
<!-- 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>Boutons dropdown séparés
Les boutons dropdown séparés distinguent l'action (bouton gauche) de la bascule du menu (petit bouton flèche). dropdown-toggle-split réduit le padding du bouton de bascule à une flèche étroite. Du texte visually-hidden (« Toggle Dropdown ») garantit l'accessibilité aux lecteurs d'écran. Les deux boutons partagent la même classe de couleur. Les boutons séparés sont idéals pour « Enregistrer » (action primaire) + menu (Enregistrer sous, Exporter, etc.). Ils fonctionnent à toutes les tailles (btn-lg/sm) et directions (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 et accordéon
Collapse de base
Collapse bascule la visibilité d'un élément avec une animation de hauteur. Déclencheur : data-bs-toggle='collapse' avec data-bs-target (bouton) ou href (ancre) pointant vers l'id de l'élément repliable. .collapse est caché ; .collapse.show est visible. aria-expanded sur le déclencheur reflète l'état ; aria-controls relie déclencheur et cible. Employez des boutons pour les actions, des ancres pour la navigation. L'animation passe en douceur de la hauteur 0 à 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>Accordéon
L'accordéon est un groupe de collapses où data-bs-parent garantit qu'un seul est ouvert à la fois (en ouvrir un referme les autres). Structure : accordion > accordion-item > accordion-header (avec accordion-button) + accordion-collapse (avec accordion-body). Le premier item peut porter la classe 'show' pour démarrer déplié. La classe 'collapsed' sur le bouton indique l'état replié (tourne la flèche). aria-expanded et aria-controls sont essentiels pour l'accessibilité. L'attribut parent crée le comportement d'ouverture exclusive.
<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>Accordéon flush et variantes
accordion-flush retire les bordures extérieures et le fond — pour une intégration dans cartes ou conteneurs sans doubles bordures. Sans data-bs-parent sur les items de collapse, plusieurs sections peuvent rester ouvertes simultanément (mode toujours ouvert). Avec data-bs-parent, en ouvrir une referme les autres (accordéon standard). Choisissez selon l'UX : exclusif (une ouverte) pour des FAQ où l'utilisateur lit une à la fois ; multi-ouvert pour navigation ou réglages où l'utilisateur compare les sections.
<!-- flush (no borders, no background) -->
<div class="accordion accordion-flush" id="accordionFlush">
<div class="accordion-item">
<h2 class="accordion-header">
<button class="accordion-button collapsed" data-bs-toggle="collapse"
data-bs-target="#flush1">
Item #1
</button>
</h2>
<div id="flush1" class="accordion-collapse collapse">
<div class="accordion-body">Flush content</div>
</div>
</div>
</div>
<!-- flush removes outer borders and background -->
<!-- always-open (no exclusive behavior) -->
<div class="accordion" id="accordionAlwaysOpen">
<div class="accordion-item">
<h2 class="accordion-header">
<button class="accordion-button" data-bs-toggle="collapse"
data-bs-target="#open1">
Item #1
</button>
</h2>
<div id="open1" class="accordion-collapse collapse show">
<!-- no data-bs-parent = stays open when others open -->
<div class="accordion-body">Content</div>
</div>
</div>
</div>Collapse via JavaScript
Contrôlez le collapse via JS : new bootstrap.Collapse(el, options). toggle: false empêche la bascule auto à l'init. parent: un sélecteur crée le comportement d'accordéon (referme les frères). Méthodes : show(), hide(), toggle(), dispose(). Événements : show/shown/hide/hidden.bs.collapse — employez shown/hidden (passé) pour les actions post-animation comme focaliser un input ou mettre à jour aria. Utile pour le contrôle par programme, comme déplier une section selon le hash d'URL ou l'état du formulaire.
<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 multi-cibles
data-bs-target accepte des sélecteurs CSS, donc un déclencheur peut basculer plusieurs éléments — employez une classe partagée (.multi-collapse) pour les viser tous. Inversement, plusieurs déclencheurs peuvent contrôler la même cible (chacun avec data-bs-target='#shared'). Utile pour des boutons « Tout montrer » / « Tout masquer » contrôlant plusieurs sections, ou pour des mises en page responsives où différents boutons contrôlent le même panneau depuis différents endroits. L'approche sélecteur est très 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>Carrousel
Carrousel de base
Les carrousels font défiler du contenu (images, texte ou personnalisé). Structure carousel > carousel-inner > carousel-item. Le premier item a besoin de la classe 'active'. carousel-control-prev/next avec data-bs-slide='prev'/'next' offrent la navigation (data-bs-target doit pointer vers l'id du carrousel). d-block w-100 sur les images les fait s'afficher correctement. data-bs-ride='carousel' active la lecture auto au chargement. Du texte visually-hidden sur les contrôles sert aux lecteurs d'écran.
<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>Carrousel avec indicateurs
carousel-indicators ajoute des points cliquables en bas — un par diapositive. data-bs-slide-to='0' saute à cet index de diapositive. L'indicateur actif reçoit la classe 'active' et aria-current='true'. Les indicateurs laissent les utilisateurs sauter directement à une diapositive sans défiler. Incluez toujours des indicateurs pour les carrousels de plus de 2-3 diapositives — ils donnent le contexte de navigation (où suis-je, combien en tout). Associez-les aux contrôles précédent/suivant pour une navigation complète.
<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>Carrousel avec légendes
carousel-caption superpose du texte aux diapositives — parfait pour les sections vedettes. d-none d-md-block masque les légendes sur mobile (où elles chevaucheraient de petites images) et les montre à md+. Les légendes peuvent porter titres, paragraphes et boutons. Pour la lisibilité sur images, ajoutez un overlay en dégradé sous la légende (semblable au pattern d'overlay d'image). Les légendes de carrousel sont la façon standard de transformer des carrousels d'images en sections vedettes marketing avec CTA.
<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>Options et fondu du carrousel
carousel-fade remplace la transition de glissement par un fondu enchaîné. carousel-dark emploie des contrôles/indicateurs sombres (pour images claires). Options : interval (ms entre diapositives auto), pause ('hover' pause au survol), wrap (boucle), touch (gestes de glissement). Méthodes JS : cycle(), pause(), next(), prev(), to(n). Événements : slide.bs.carousel (en cours) et slid.bs.carousel (fini) fournissent les indices from/to pour des animations personnalisées ou l'analytique.
<!-- 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>Carrousel tactile et responsif
Le glissement tactile est actif par défaut (data-bs-touch='true'). Pour des carrousels responsifs avec différentes images par breakpoint, empilez deux imgs avec d-block d-md-none (mobile) et d-none d-md-block (desktop) dans le même carousel-item — un seul s'affiche à la fois. data-bs-ride='false' désactive la lecture auto (navigation manuelle seulement). data-bs-pause='hover' met en pause au survol — envisagez-le pour du contenu que l'utilisateur doit lire. Testez toujours les carrousels sur appareils tactiles pour le comportement de glissement.
<!-- 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>Icônes et accessibilité
Bootstrap Icons
Bootstrap Icons est une bibliothèque d'icônes séparée (non incluse dans le CSS). Incluez le CSS, puis employez <i class='bi bi-{nom}'></i>. Dimensionnez les icônes avec les utilitaires fs-* (font-size). Colorez-les avec les classes text-*. Les icônes dans les boutons améliorent l'UX avec des indices visuels. Les boutons à icône seule DOIVENT porter un aria-label pour les lecteurs d'écran — sans lui, le bouton n'a pas de nom accessible. Parcourez les icônes à icons.getbootstrap.com. Ce sont des polices SVG, elles passent donc à l'échelle nettement à toute taille.
<!-- 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>Accessibilité : ARIA et rôles
Les composants Bootstrap incluent des attributs ARIA, mais il faut les ajouter pour les contrôles personnalisés. aria-label fournit des noms aux boutons à icône seule. aria-labelledby référence l'id d'un autre élément comme label. aria-describedby pointe vers un texte d'aide. aria-expanded reflète l'état de bascule (true/false). aria-current='page' marque l'item de nav courant. Employez le HTML sémantique (nav, main, aside, header, footer) qui porte des rôles ARIA implicites — mieux que d'ajouter des attributs role à des 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 et lecteurs d'écran
visually-hidden masque le contenu visuellement mais le garde pour les lecteurs d'écran — employez-le pour les labels des boutons à icône seule ou du contexte supplémentaire. visually-hidden-focusable est caché jusqu'au focus clavier (parfait pour les liens « Aller au contenu principal » qui apparaissent au Tab). aria-hidden='true' fait l'inverse : visible mais non annoncé (pour les éléments décoratifs). Fournissez toujours un lien d'évitement comme premier élément focalisable pour l'accessibilité clavier. Essentiel pour la conformité 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>Mouvement réduit et mode sombre
Mode sombre : réglez data-bs-theme='dark' sur <html> — Bootstrap échange les variables CSS. Basculez via JS en changeant l'attribut. Respectez la préférence système avec matchMedia('(prefers-color-scheme: dark)'). Pour le mouvement réduit, Bootstrap désactive automatiquement la plupart des animations quand l'utilisateur a prefers-reduced-motion: reduce. Vous pouvez ajouter plus de règles pour réduire davantage le mouvement. Stockez la préférence de thème de l'utilisateur en localStorage. Ces fonctionnalités rendent votre site accessible et confortable pour tous.
<!-- 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;
}
}Gestion du focus et clavier
Ne retirez jamais les contours de focus (outline: none) sans fournir d'alternative — les utilisateurs clavier en ont besoin. Le focus-visible de Bootstrap montre l'anneau seulement au focus clavier, pas à la souris. Pour les modales, déplacez le focus dans la modale à l'affichage et rendez-le au déclencheur au masquage. Les widgets personnalisés (onglets, menus) exigent la navigation aux flèches — implémentez des handlers keydown pour les flèches, Entrée, Espace et Échap. Une gestion correcte de tabindex (0 pour focalisable, -1 pour focalisable par programme) garantit un ordre de tabulation logique. Essentiel pour les utilisateurs clavier seuls.
<!-- 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 de base
list-group est un composant flexible pour afficher une série de contenus. list-group-item style chaque entrée. active marque l'item courant ; disabled le grise (employez aria-disabled='true' pour l'accessibilité). Les list groups sont plus sémantiques que des divs stylées pour les listes de contenus liés comme dashboards, réglages ou boîtes de réception. Employez <ul>/<li> pour les listes de navigation, ou <div> pour le contenu hors liste.
<!-- 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 avec liens et boutons
Pour des items de liste actionnables (cliquables), employez list-group-item-action sur des éléments <a> ou <button>. Cela ajoute les états hover et focus. Employez <a> pour la navigation (avec href) et <button type='button'> pour les actions. Désactivez les liens avec la classe .disabled (et aria-disabled) ; les boutons avec l'attribut disabled. Évitez <li> pour les items actionnables — employez <div> comme enveloppe de list-group, car <a>/<button> dans <ul> est moins sémantique.
<!-- 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 et numéroté
list-group-flush retire les bordures et coins arrondis — pour un encastrement dans cartes ou conteneurs sans doubles bordures. list-group-numbered (sur <ol>) ajoute une numérotation automatique via compteurs CSS. list-group-horizontal place les items côte à côte ; les variantes responsives (list-group-horizontal-md) passent en horizontal à un breakpoint. Les listes horizontales servent aux petites navigations ou barres de filtres. Les listes numérotées conviennent aux instructions pas à pas ou classements.
<!-- 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>Couleurs contextuelles et badges de list group
Les classes contextuelles (list-group-item-{couleur}) teintent les items pour l'indication de statut — employez-les avec sens (success=fini, danger=erreur). Pour les badges dans les items de liste, employez d-flex justify-content-between align-items-center pour pousser le badge à droite et le centrer verticalement. Les badges rounded-pill paraissent modernes pour les comptes. Ce pattern est la liste classique de boîte de réception/notifications : label à gauche, compte à droite. Les utilitaires flex gèrent l'alignement sans CSS personnalisé.
<!-- 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>Contenu personnalisé de list group
Les items de liste peuvent porter du contenu riche : titres (fw-bold), descriptions (text-muted), métadonnées (small) et badges. Employez d-flex justify-content-between align-items-start pour disposer contenu et badge. me-auto pousse le badge à droite. Pour des checkboxes/radios dans les items, employez form-check-input avec un form-check-label correspondant — cela crée des listes sélectionnables. Cas d'usage courants : listes d'emails, panneaux de réglages et résultats de recherche où chaque item a titre, description et statut.
<!-- rich content list item -->
<ul class="list-group">
<li class="list-group-item d-flex justify-content-between align-items-start">
<div class="ms-2 me-auto">
<div class="fw-bold">Subheading</div>
<p class="mb-0 text-muted">Descriptive text for the list item.</p>
<small>Additional metadata</small>
</div>
<span class="badge bg-primary rounded-pill">New</span>
</li>
<li class="list-group-item d-flex justify-content-between align-items-start">
<div class="ms-2 me-auto">
<div class="fw-bold">Another item</div>
<p class="mb-0">More content here.</p>
</div>
<span class="badge bg-secondary rounded-pill">3</span>
</li>
</ul>
<!-- list group with checkbox/radio -->
<ul class="list-group">
<li class="list-group-item">
<input class="form-check-input me-1" type="checkbox" id="check1">
<label class="form-check-label" for="check1">Checkbox item</label>
</li>
<li class="list-group-item">
<input class="form-check-input me-1" type="radio" name="radio" id="radio1">
<label class="form-check-label" for="radio1">Radio item</label>
</li>
</ul>Snippets Bootstrap associés
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?