Skip to content

Bootstrap チートシート

CSS と JavaScript を基盤とした、強力で拡張可能かつ多機能なフロントエンドツールキット。

01

はじめに

Bootstrap の読み込み

クイックスタートには CDN の利用が便利です — CSS は <head> に、JS バンドル(Popper を含む)は </body> の前に置きます。bundle.min.js にはツールチップ/ドロップダウン/ポップオーバー向けの Popper が含まれます。npm の場合はエントリファイルで CSS と JS をインポートします。Bootstrap 5 は jQuery への依存を廃止しました — すべてのコンポーネントがバニラ JS で動きます。

bootstrap
<!-- CSS only (in <head>) -->
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">

<!-- JS bundle (before </body>) -->
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>

<!-- or install via npm -->
<!-- npm install [email protected] -->

<!-- import in JS -->
// import 'bootstrap/dist/css/bootstrap.min.css'
// import 'bootstrap'  // imports all JS

コンテナ

コンテナは最も基本のレイアウト要素です — コンテンツを中央に寄せ、横方向のパディングを付けます。.container は各ブレークポイントで固定幅(max-width が変化)になり、.container-fluid は常に幅 100% です。レスポンシブコンテナ(container-sm/md/lg/xl/xxl)は指定ブレークポイントまでは 100% 幅、それ以降は固定幅になります。ほとんどのレイアウトには .container、全幅のアプリには .container-fluid を使いましょう。

bootstrap
<!-- fixed-width container (responsive breakpoints) -->
<div class="container">
  <!-- content centered with max-width -->
</div>

<!-- full-width container -->
<div class="container-fluid">
  <!-- spans entire viewport width -->
</div>

<!-- responsive containers (max-width at breakpoint) -->
<div class="container-sm">  <!-- 100% until sm, then fixed -->
<div class="container-md">
<div class="container-xl">

<!-- 100% wide until the breakpoint, then max-width applied -->
<div class="container-xxl">

レスポンシブブレークポイント

Bootstrap はモバイルファーストの min-width メディアクエリシステムを採用しています。6 つのブレークポイント:xs(デフォルト)、sm(576px)、md(768px)、lg(992px)、xl(1200px)、xxl(1400px)。col-md-6 のようなクラスは md 以上で適用されます。表示/非表示の切り替えには d-none(display:none)と d-{breakpoint}-block を使います。モバイルファーストとは、小さい画面向けにスタイルを作ってから大きな画面向けに複雑さを足していく考え方です。

bootstrap
/* Bootstrap 5 breakpoints (min-width, mobile-first) */
/* xs: <576px  (default, no media query needed) */
/* sm: >=576px */
/* md: >=768px */
/* lg: >=992px */
/* xl: >=1200px */
/* xxl: >=1400px */

<!-- classes apply AT and ABOVE the breakpoint -->
<div class="col-12 col-md-6 col-lg-4">
  <!-- full width on mobile, half on md, third on lg -->
</div>

<!-- hidden/visible at breakpoints -->
<div class="d-none d-md-block">  <!-- hidden below md -->
<div class="d-block d-md-none">  <!-- visible below md only -->

Reboot と基本スタイル

Reboot は Bootstrap の CSS リセットです — html のフォントサイズ 16px を基準にした rem 単位でブラウザスタイルを正規化します。すべての要素に box-sizing: border-box が適用されます。見出し、段落、リスト、テーブル、リンクに適切なデフォルトが与えられ、見出しとリストの上マージンは 0 にされます。これにより Bootstrap のコンポーネントが重なる前の、ブラウザ間で一貫したベースラインが得られます。

bootstrap
<!-- Reboot normalizes styles: box-sizing, margins, etc. -->
<!-- body gets: font-family, font-size (1rem), line-height (1.5), color -->

<!-- headings use rem units, margin-top removed -->
<h1>Heading 1 (2.5rem)</h1>
<h2>Heading 2 (2rem)</h2>

<!-- links get color and underline on hover -->
<a href="#">Default link</a>

<!-- tables get basic styling -->
<table class="table">...</table>

<!-- <ul>/<ol> have padding-left removed -->
<ul>
  <li>Item</li>
</ul>

CSS 変数によるカスタマイズ

Bootstrap 5 は --bs- 接頭辞付きの何百もの CSS カスタムプロパティ(変数)を公開しています。:root で上書きすればサイト全体をテーマ化できます。ダークモードは <html> 要素の data-bs-theme='dark' で組み込み対応しており、一連の変数が切り替わります。これで旧来の Sass 変数アプローチよりはるかにテーマ化が容易になり — ビルド工程なしで、素の CSS だけで色、フォント、スペーシング、角丸を変更できます。

bootstrap
:root {
  /* override Bootstrap's CSS variables */
  --bs-primary: #0d6efd;
  --bs-body-bg: #ffffff;
  --bs-body-color: #212529;
  --bs-font-sans-serif: 'Inter', system-ui, sans-serif;
  --bs-border-radius: 0.375rem;
}

/* dark mode via data attribute */
[data-bs-theme="dark"] {
  --bs-body-bg: #212529;
  --bs-body-color: #f8f9fa;
}

<!-- use in HTML -->
<div style="background: var(--bs-primary); color: var(--bs-white);">
  Custom styled
</div>
02

レイアウトの基本

行と列

.row は列のパディングを相殺するネガティブな横マージンを持つ flex コンテナ(display: flex)です。直下の .col 子要素は等分に flex で行を埋めます。col-{1-12} で固定比率(12 分割)を指定します。数字なしの .col は残りのスペースを均等に取ります。12 列グリッドが Bootstrap レイアウトの核心です — col-{n} と自動 .col を組み合わせて柔軟なレイアウトを作りましょう。

bootstrap
<!-- .row creates a flex container with negative margins -->
<!-- .col children flex equally -->
<div class="container">
  <div class="row">
    <div class="col">Column 1</div>
    <div class="col">Column 2</div>
    <div class="col">Column 3</div>
  </div>
  <!-- 3 equal columns -->
</div>

<!-- sized columns -->
<div class="row">
  <div class="col-8">8/12 width</div>
  <div class="col-4">4/12 width</div>
</div>

<!-- auto + sized -->
<div class="row">
  <div class="col">auto width (content-based)</div>
  <div class="col-6">exactly half</div>
  <div class="col">auto width</div>
</div>

ガター(列間のスペーシング)

ガターは列間のパディングで、g-* クラス(g-0 から g-5)で制御します。g-0 はすべてのガターを除去(列が端から端まで)し、g-3 がデフォルトです。ガターは横方向(列間)と縦方向(列が折り返したときの行間)の両方に効きます。ブレークポイントごとに異なる間隔にするにはレスポンシブ版(g-2 g-md-4)を使います。ガターシステムは、旧来の横パディングのみのガターアプローチを置き換えたものです。

bootstrap
<!-- default gutters (1.5rem padding on each side of columns) -->
<div class="row">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- remove gutters -->
<div class="row g-0">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- custom gutter sizes: g-0 to g-5 -->
<div class="row g-3">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- responsive gutters -->
<div class="row g-2 g-md-4">
  <div class="col-6">A</div>
  <div class="col-6">B</div>
</div>

<!-- vertical gutters (row spacing) -->
<div class="row g-3">
  <div class="col-12">Row 1</div>
  <div class="col-12">Row 2 (g-3 gap above)</div>
</div>

列の折り返しと整列

列の合計が 12 を超えると次の行へ折り返します。垂直方向の整列は行に align-items-*(start/center/end)で、水平方向の分配は justify-content-*(start/center/end/between/around/evenly)で制御します。これらは内部で flexbox を使っています。折り返しは自動 — 明示的な行区切りは不要です。col-* クラスだけで masonry 風のレイアウトも簡単に作れます。

bootstrap
<!-- columns wrap when they exceed 12 total -->
<div class="row">
  <div class="col-9">9 cols</div>
  <div class="col-4">4 cols → wraps to next line (9+4=13)</div>
  <div class="col-6">6 cols (new line)</div>
</div>

<!-- vertical alignment -->
<div class="row align-items-center">
  <div class="col">Vertically centered</div>
</div>

<!-- options: align-items-start, -center, -end -->
<div class="row align-items-end">...</div>

<!-- horizontal alignment -->
<div class="row justify-content-center">
  <div class="col-6">Centered horizontally</div>
</div>

<!-- options: justify-content-start, -center, -end, -between, -around, -evenly -->

列の順序

order クラスは HTML を変えずに列の見た目上の順序を入れ替えます。order-first、order-{1-5}、order-last の 7 段階があります。レスポンシブ版(order-md-first)でブレークポイントごとに順序を変えられます — 重要なコンテンツを HTML では先頭に置き(SEO)、モバイルでは異なる位置に表示するのに有用です。オフセット(offset-md-4)は左マージンを加えて列を右へ押します — 中央寄せやインデントに便利です。どちらも flexbox の order とマージンユーティリティに基づいています。

bootstrap
<!-- order classes: order-first, order-{1-5}, order-last -->
<div class="row">
  <div class="col order-2">First in HTML, second visually</div>
  <div class="col order-1">Second in HTML, first visually</div>
  <div class="col order-3">Third in both</div>
</div>

<!-- responsive ordering -->
<div class="row">
  <div class="col order-last order-md-first">
    Last on mobile, first on desktop
  </div>
  <div class="col">Normal</div>
</div>

<!-- column offset (push right) -->
<div class="row">
  <div class="col-md-4 offset-md-4">Centered (offset 4)</div>
</div>

<!-- offset responsive -->
<div class="col-md-4 offset-md-2 offset-lg-4">...</div>

Z-Index とスタッキング

Bootstrap はスタッキングに z-index スケールを使います:z-1、z-2、z-3(および負の z-n0、z-n1、z-n2)。モーダル、ドロップダウン、ツールチップなどのコンポーネントはより高い組み込み z-index(1000〜1080)を持ちます。z-index が効くには要素に position(relative、absolute、fixed、sticky のいずれか)が必要です。任意の z-index 値は避け、一貫性のために Bootstrap のスケールを使いましょう。モーダルがドロップダウンより上、ドロップダウンがナビバーより上になるよう設計されています。

bootstrap
/* Bootstrap's z-index scale */
/* z-1 to z-3, plus z-n0, z-n1, z-n2 for negatives */

<div class="z-3 position-relative">High z-index</div>
<div class="z-1 position-relative">Low z-index</div>

<!-- components have built-in z-index: -->
/* dropdown: 1000 */
/* sticky: 1020 */
/* fixed: 1030 */
/* modal-backdrop: 1050 */
/* modal: 1055 */
/* popover: 1070 */
/* tooltip: 1080 */

<!-- use position utilities for stacking context -->
<div class="position-relative z-3">
  Needs position for z-index to apply
</div>
03

グリッドシステム

基本のグリッド

Bootstrap のグリッドは 12 列システムです。col-{1-12} は 12 列のうち何列分の幅を使うかを指定します。col-12 は全幅、col-6 は半分、col-4 は 3 分の 1、col-3 は 4 分の 1 です。行内の列は合計 12 になるようにします(それ未満なら残りが分配されます)。数字なしの .col は残りスペースを均等に分割します。グリッドは flexbox ベースで — 行が flex コンテナ、列が flex アイテムです。

bootstrap
<!-- 12-column grid -->
<div class="container">
  <div class="row">
    <div class="col-12">Full width (12/12)</div>
  </div>
  <div class="row">
    <div class="col-6">Half (6/12)</div>
    <div class="col-6">Half (6/12)</div>
  </div>
  <div class="row">
    <div class="col-4">Third (4/12)</div>
    <div class="col-4">Third (4/12)</div>
    <div class="col-4">Third (4/12)</div>
  </div>
  <div class="row">
    <div class="col-3">Quarter (3/12)</div>
    <div class="col-9">Three-quarters (9/12)</div>
  </div>
</div>

レスポンシブな列

レスポンシブな列クラス(col-sm-*、col-md-*、col-lg-*、col-xl-*、col-xxl-*)はそのブレークポイント以上で適用されます(モバイルファースト)。適用される最も小さいクラスが優先されます。col-12 col-md-6 col-lg-4 は:モバイルで全幅、タブレットで半分、デスクトップで 3 分の 1 という意味です。row-cols-* は 1 行あたりの等幅列数をブレークポイントで設定します — すべての列が同じ幅なら、子ごとに col-* を書くより簡単です。

bootstrap
<!-- different widths at different breakpoints -->
<div class="row">
  <!-- full on mobile, half on md, third on lg -->
  <div class="col-12 col-md-6 col-lg-4">Card 1</div>
  <div class="col-12 col-md-6 col-lg-4">Card 2</div>
  <div class="col-12 col-md-6 col-lg-4">Card 3</div>
</div>

<!-- mobile-first: base class applies to all, -->
<!-- larger breakpoints override -->
<div class="col-12 col-sm-6 col-md-4 col-lg-3 col-xl-2">
  1 per row on xs, 2 on sm, 3 on md, 4 on lg, 6 on xl
</div>

<!-- equal-width columns at breakpoint -->
<div class="row row-cols-1 row-cols-md-2 row-cols-lg-3">
  <div class="col">Auto-width card</div>
  <div class="col">Auto-width card</div>
  <div class="col">Auto-width card</div>
</div>

列のネスト

グリッドをネストするには、.col の中に .row を置きます — ネストした行は親の列幅の中で新しい 12 列コンテキストを作ります。ネストした列(col-4、col-8)はページ全体ではなく親の幅を分割します。サブセクション付きのサイドバーのような複雑なレイアウトにはネストが不可欠です。列が極端に狭くならないよう、ネストは浅く(最大 2〜3 レベル)保ちましょう。

bootstrap
<!-- nest a row inside a column -->
<div class="row">
  <div class="col-6">
    <!-- outer column -->
    <h3>Left half</h3>
    <!-- nested row: new 12-column context -->
    <div class="row">
      <div class="col-4">Nested 1/3 of parent</div>
      <div class="col-8">Nested 2/3 of parent</div>
    </div>
  </div>
  <div class="col-6">
    <h3>Right half</h3>
  </div>
</div>

<!-- the nested row creates a new 12-col grid -->
<!-- within the parent column's width -->

列のオフセットとマージン

offset-{breakpoint}-{n} は n 列分の左マージンを追加します — 中央寄せやインデントに有用です。col-md-4 に offset-md-4 を付けると中央に来ます(4 + 4 + 4 = 12)。もっと単純に中央寄せするには mx-auto(margin: 0 auto)が使えます — 列数に依存しません。レスポンシブなオフセット(offset-sm-2 offset-md-0)で、モバイルではインデントしてデスクトップでは解除できます。空のスペーサー列よりオフセットがきれいです。

bootstrap
<!-- offset: add left margin (empty columns) -->
<div class="row">
  <div class="col-md-4 offset-md-4">
    Centered (4 + 4 offset each side = 12)
  </div>
</div>

<!-- offset only on one side -->
<div class="row">
  <div class="col-md-6 offset-md-3">
    Centered with more left space
  </div>
</div>

<!-- responsive offset -->
<div class="row">
  <div class="col-sm-8 offset-sm-2 offset-md-0 col-md-12">
    Offset on mobile, none on desktop
  </div>
</div>

<!-- margin utilities for auto centering -->
<div class="row">
  <div class="col-md-6 mx-auto">
    Auto-centered (margin: 0 auto)
  </div>
</div>

Row Columns とオートレイアウト

row-cols-{n} は 1 行あたりの等幅列数を設定します — すべて同じ幅なら子ごとに col-* を足すよりずっときれいです。row-cols-2 なら 1 行 2 列で、アイテムは自動的に折り返します。レスポンシブ版(row-cols-1 row-cols-md-3)でブレークポイントごとに数を変えられます。数字なしの .col はスペースを均等に分割します。カードグリッドには row-cols、列ごとに特別な比率が要るときは col-{n} を使いましょう。

bootstrap
<!-- row-cols: set number of columns per row -->
<div class="row row-cols-2">
  <div class="col">Item 1</div>
  <div class="col">Item 2</div>
  <div class="col">Item 3</div>  <!-- wraps to new row -->
  <div class="col">Item 4</div>
</div>
<!-- 2 per row automatically -->

<!-- responsive row-cols -->
<div class="row row-cols-1 row-cols-sm-2 row-cols-md-3 row-cols-lg-4">
  <div class="col">Card</div>
  <div class="col">Card</div>
  <div class="col">Card</div>
  <div class="col">Card</div>
</div>

<!-- auto-fit columns: .col without number -->
<div class="row">
  <div class="col">Equal</div>
  <div class="col">Equal</div>
  <div class="col">Equal</div>
</div>
<!-- each takes 1/3, regardless of content -->
04

タイポグラフィ

見出しと Display

Bootstrap は h1〜h6 を rem ベースのサイズで整形します(h1 = 2.5rem、h6 = 1rem)。.h1〜.h6 クラスは任意の要素に見出しスタイルを適用します。display 見出し(display-1〜display-6)はより大きく細く — ヒーローセクション向けです。.lead は段落を少し大きく軽くします — 主に最初の段落に使います。見出しはデフォルトで上マージンがなく(Reboot が除去)、レイアウトの隙間を避けられます。

bootstrap
<!-- standard headings (h1-h6) -->
<h1>h1 heading</h1>
<h2>h2 heading</h2>
<h3>h3 heading</h3>

<!-- heading classes for matching styles -->
<p class="h1">Looks like h1</p>
<p class="h2">Looks like h2</p>

<!-- display headings (larger, thinner) -->
<h1 class="display-1">Display 1</h1>
<h1 class="display-2">Display 2</h1>
<h1 class="display-3">Display 3</h1>
<h1 class="display-4">Display 4</h1>
<h1 class="display-5">Display 5</h1>
<h1 class="display-6">Display 6</h1>

<!-- lead paragraph -->
<p class="lead">This is a lead paragraph.</p>

インラインテキスト要素

Bootstrap はセマンティックな HTML 要素を整形します:<mark>(ハイライト)、<del>/<s>(打ち消し線)、<ins>/<u>(下線)、<small>(細字注記)。テキストユーティリティによるスタイリング:text-uppercase/lowercase/capitalize、fw-bold/light/normal、fst-italic、text-muted(グレー)。text-decoration-underline/line-through で下線を制御します。一貫性のためインラインスタイルよりこれらのユーティリティを推奨します。

bootstrap
<!-- text styling -->
<p>You can use <mark>highlight</mark> text.</p>
<p><del>Deleted</del> and <s>strikethrough</s> text.</p>
<p><ins>Inserted</ins> and <u>underline</u> text.</p>
<p><small>Small text</small> for fine print.</p>
<p><strong>Bold</strong> and <em>italic</em> text.</p>

<!-- text utilities -->
<p class="text-decoration-underline">Underlined</p>
<p class="text-decoration-line-through">Line through</p>
<p class="text-lowercase">lowercase text</p>
<p class="text-uppercase">UPPERCASE TEXT</p>
<p class="text-capitalize">Capitalized Text</p>
<p class="fw-bold">Font weight bold</p>
<p class="fw-light">Font weight light</p>
<p class="fst-italic">Font style italic</p>
<p class="text-muted">Muted/gray text</p>

リスト

list-unstyled はデフォルトのリストスタイル(黒点と左パディング)を除去します — ナビゲーションメニューに有用です。list-inline はリスト項目をインライン表示にします(タグクラウド、パンくず用)。記述リスト(dl/dt/dd)は row クラスで横並びのレイアウトになります — dt が左、dd が右で、グリッドで整列します。Bootstrap のリストは一貫した間隔のため margin-top: 0 と margin-bottom: 1rem を持ちます。

bootstrap
<!-- unordered list -->
<ul>
  <li>Item 1</li>
  <li>Item 2</li>
</ul>

<!-- unstyled list (no bullets, no padding) -->
<ul class="list-unstyled">
  <li>No bullets</li>
  <li>No left padding</li>
</ul>

<!-- inline list -->
<ul class="list-inline">
  <li class="list-inline-item">Inline 1</li>
  <li class="list-inline-item">Inline 2</li>
  <li class="list-inline-item">Inline 3</li>
</ul>

<!-- description list -->
<dl>
  <dt>Term</dt>
  <dd>Definition</dd>
</dl>

<!-- horizontal description list -->
<dl class="row">
  <dt class="col-sm-3">Term</dt>
  <dd class="col-sm-9">Definition</dd>
</dl>

ブロック引用とコード

ブロック引用はセマンティクスのため <figure>/<blockquote>/<figcaption> 構造を使います。blockquote-footer が出典を整形します。コードのスタイリング:インラインコードは <code>、コードブロックは <pre><code>、キーボードのキーは <kbd>、変数は <var>。コード内の山括弧は必ず HTML エスケープしてください(< は &lt;)。ブロック引用は text-center/text-end で整列できます。kbd のスタイルはキーをキーボード風の見た目にします。

bootstrap
<!-- blockquote with source -->
<figure>
  <blockquote class="blockquote">
    <p>A well-known quote.</p>
  </blockquote>
  <figcaption class="blockquote-footer">
    Someone famous in <cite title="Source Title">Source Title</cite>
  </figcaption>
</figure>

<!-- blockquote alignment -->
<blockquote class="blockquote text-center">Centered</blockquote>
<blockquote class="blockquote text-end">Right-aligned</blockquote>

<!-- inline code -->
<p>Use <code>&lt;section&gt;</code> tag.</p>

<!-- code block -->
<pre><code>&lt;div class="container"&gt;
  Hello
&lt;/div&gt;
</code></pre>

<!-- variables -->
<var>y</var> = <var>mx</var> + <var>b</var>

<!-- keyboard input -->
<kbd>Ctrl</kbd> + <kbd>C</kbd>

テキストの整列と折り返し

テキストの整列:text-start/center/end(Bootstrap 5 は RTL 対応のため left/right を start/end に改名)。レスポンシブ版(text-md-start)でブレークポイントごとに整列を変えられます。text-nowrap は折り返しを禁止し、text-truncate ははみ出しに省略記号を付けます(max-width か制約のあるコンテナが必要)。text-break は長い単語を折ります。lh-* は行の高さを制御します。これらのユーティリティでカスタム CSS なしにテキストフローを扱えます。

bootstrap
<!-- text alignment -->
<p class="text-start">Left aligned (default)</p>
<p class="text-center">Center aligned</p>
<p class="text-end">Right aligned</p>

<!-- responsive alignment -->
<p class="text-center text-md-start">
  Center on mobile, left on md+
</p>

<!-- text wrapping -->
<div class="text-wrap">This text wraps.</div>
<div class="text-nowrap">This text doesn't wrap.</div>

<!-- truncate with ellipsis -->
<div class="text-truncate" style="max-width: 200px;">
  This long text will be truncated with an ellipsis...
</div>

<!-- word break -->
<p class="text-break">verylongwordwithoutspaces</p>

<!-- line height -->
<p class="lh-1">Line height 1</p>
<p class="lh-sm">Line height small</p>
<p class="lh-base">Line height base (default)</p>
<p class="lh-lg">Line height large</p>
05

テーブル

基本のテーブル

.table クラスはパディング、罫線、横の区切り線を追加します。ヘッダーは <thead>、データは <tbody> を使います。ヘッダーの <th> に scope='col'、行の <th> に scope='row' を付けるとスクリーンリーダーのアクセシビリティが向上します。テーブルはオプトイン方式 — .table がなければスタイルなしの HTML テーブルになります。アクセシビリティのため必ずセマンティックなテーブル要素(thead、tbody、th、tr、td)を使いましょう。

bootstrap
<!-- basic table with styling -->
<table class="table">
  <thead>
    <tr>
      <th scope="col">#</th>
      <th scope="col">Name</th>
      <th scope="col">Email</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">1</th>
      <td>Alice</td>
      <td>[email protected]</td>
    </tr>
    <tr>
      <th scope="row">2</th>
      <td>Bob</td>
      <td>[email protected]</td>
    </tr>
  </tbody>
</table>

テーブルのバリエーションと縞模様

テーブルの修飾:table-striped(行の色を交互に)、table-bordered(全罫線)、table-borderless(罫線なし)、table-hover(ホバーで行をハイライト)、table-sm(パディングを詰める)、table-dark(ダークテーマ)。組み合わせ可能です:table table-striped table-hover。dark バリアントはダーク背景向けに色を反転します。table-sm はセルのパディングを半減させ、データを密に表示できます。

bootstrap
<!-- striped rows -->
<table class="table table-striped">
  <!-- alternating background colors -->
</table>

<!-- bordered table -->
<table class="table table-bordered">
  <!-- borders on all sides -->
</table>

<!-- borderless table -->
<table class="table table-borderless">
  <!-- no borders -->
</table>

<!-- hoverable rows -->
<table class="table table-hover">
  <!-- row highlights on hover -->
</table>

<!-- small table -->
<table class="table table-sm">
  <!-- condensed padding -->
</table>

<!-- dark table -->
<table class="table table-dark">
  <!-- dark background -->
</table>

テーブルの色

文脈クラスを <tr> や <td> に適用します:table-primary、table-success、table-danger、table-warning、table-info、table-secondary、table-light、table-dark、table-active。状態表示のための控えめな背景色を付けられます。ダークテーブルでは同じクラスが明るいバリアントになります。装飾ではなく意味のある状態(成功 = 完了、危険 = エラー)に控えめに使いましょう。

bootstrap
<!-- contextual row/cell colors -->
<table class="table">
  <thead>
    <tr class="table-primary"><th>Primary header</th></tr>
  </thead>
  <tbody>
    <tr class="table-success">
      <td>Success row (green)</td>
    </tr>
    <tr class="table-danger">
      <td>Danger row (red)</td>
    </tr>
    <tr class="table-warning">
      <td>Warning row (yellow)</td>
    </tr>
    <tr class="table-info">
      <td>Info row (cyan)</td>
    </tr>
    <!-- individual cells -->
    <tr>
      <td class="table-active">Active cell</td>
      <td>Normal cell</td>
    </tr>
  </tbody>
</table>

レスポンシブテーブル

テーブルを .table-responsive で包むと小さな画面で横スクロールが有効になります(レイアウト崩れを防止)。table-responsive-sm/md/lg/xl/xxl はそのブレークポイント未満でのみスクロールし、大きな画面では普通に収まります。レスポンシブなラッパーがないと、幅の広いテーブルはコンテナからはみ出します。overflow は <table> に直接適用できないためラッパー div が必要です。列の多いテーブルには必ず使いましょう。

bootstrap
<!-- responsive table (horizontal scroll on small screens) -->
<div class="table-responsive">
  <table class="table">
    <!-- scrolls horizontally on small screens -->
    <thead>...</thead>
    <tbody>...</tbody>
  </table>
</div>

<!-- responsive at specific breakpoints -->
<div class="table-responsive-sm">
  <!-- scrolls below sm -->
</div>
<div class="table-responsive-md">
  <!-- scrolls below md -->
</div>
<div class="table-responsive-lg">
  <!-- scrolls below lg -->
</div>

<!-- always scrollable -->
<div class="table-responsive">...</div>

テーブルのグループとキャプション

caption-top はキャプションをテーブルの上へ移動します(デフォルトは下)。キャプションはスクリーンリーダーのアクセシビリティを高めます。thead/tbody/tfoot は table-light/table-dark で個別に整形できます。垂直方向の整列:セルや行に align-top、align-middle、align-bottom — セルの内容の高さが異なるときに有用です。tfoot 要素はデフォルトで thead と同様に整形されますが、カスタマイズ可能です。

bootstrap
<!-- caption (accessibility, shown below table by default) -->
<table class="table caption-top">
  <caption>List of users</caption>
  <thead>
    <tr><th>#</th><th>Name</th></tr>
  </thead>
  <tbody>
    <tr><td>1</td><td>Alice</td></tr>
  </tbody>
</table>

<!-- table groups for styling -->
<table class="table">
  <thead class="table-light">
    <tr><th>Light header</th></tr>
  </thead>
  <tbody>
    <tr><td>Body</td></tr>
  </tbody>
  <tfoot class="table-dark">
    <tr><td>Dark footer</td></tr>
  </tfoot>
</table>

<!-- vertically aligned cells -->
<tr class="align-middle">
  <td class="align-top">Top</td>
  <td class="align-middle">Middle</td>
  <td class="align-bottom">Bottom</td>
</tr>
06

フォーム

フォームコントロール

form-control はテキスト入力、テキストエリア、ファイル入力を整形します。form-select はドロップダウンを整形します。アクセシビリティのため、入力には必ず <label> 要素(for/id を一致させる)をペアにしましょう。form-label が適切な間隔を加えます。disabled は操作を防ぎ、readonly は編集不可で値を表示します。mb-3(margin-bottom)でフォームグループ間に間隔を付けます。.form-control クラスは一貫した高さ、パディング、フォーカススタイルを適用します。

bootstrap
<!-- text input -->
<div class="mb-3">
  <label for="email" class="form-label">Email</label>
  <input type="email" class="form-control" id="email" placeholder="Enter email">
</div>

<!-- textarea -->
<div class="mb-3">
  <label for="bio" class="form-label">Bio</label>
  <textarea class="form-control" id="bio" rows="3"></textarea>
</div>

<!-- select -->
<select class="form-select" aria-label="Default select">
  <option selected>Open this select menu</option>
  <option value="1">One</option>
  <option value="2">Two</option>
</select>

<!-- disabled -->
<input class="form-control" type="text" placeholder="Disabled" disabled>
<input class="form-control" type="text" value="Readonly" readonly>

フォームグリッドとレイアウト

フォームのレイアウトにはグリッドシステム(row/col)を使います。水平フォームでは、col-form-label と col-* を組み合わせてラベル/入力を整列させます。row-cols-lg-auto は大きな画面でフォーム要素をコンテンツサイズにします(インラインフォーム)。align-items-center でラベルと入力を垂直に整列させます。グリッドにより、カスタム CSS なしでブレークポイントごとにフォームレイアウトを精密に制御できます。

bootstrap
<!-- form using grid -->
<div class="row mb-3">
  <label for="name" class="col-sm-2 col-form-label">Name</label>
  <div class="col-sm-10">
    <input type="text" class="form-control" id="name">
  </div>
</div>

<!-- inline form -->
<form class="row row-cols-lg-auto g-3 align-items-center">
  <div class="col">
    <input class="form-control" placeholder="Email">
  </div>
  <div class="col">
    <input class="form-control" placeholder="Password">
  </div>
  <div class="col">
    <button type="submit" class="btn btn-primary">Sign in</button>
  </div>
</form>

<!-- horizontal form with column sizing -->
<form>
  <div class="row mb-3">
    <label class="col-2 col-form-label">Email</label>
    <div class="col-10">
      <input class="form-control" type="email">
    </div>
  </div>
</form>

インプットグループ

インプットグループは input-group-text で入力にテキスト/ボタンを前後に付けられます。@ ユーザー名、$ 通貨、.00 小数、検索ボタンによく使われます。input-group ラッパーによりアドオンと入力が 1 つの連結コントロールに見えます。複数の入力が 1 つのアドオンを共有することもできます。インプットグループ内のボタンは連結した見た目のため btn-outline-* を使います。input-group と form-floating の混在は避けましょう。

bootstrap
<!-- prepend text -->
<div class="input-group mb-3">
  <span class="input-group-text">@</span>
  <input type="text" class="form-control" placeholder="Username">
</div>

<!-- append text -->
<div class="input-group mb-3">
  <input type="text" class="form-control" placeholder="Recipient's username">
  <span class="input-group-text">@example.com</span>
</div>

<!-- prepend + append -->
<div class="input-group mb-3">
  <span class="input-group-text">$</span>
  <input type="text" class="form-control">
  <span class="input-group-text">.00</span>
</div>

<!-- with button -->
<div class="input-group mb-3">
  <input type="text" class="form-control" placeholder="Search">
  <button class="btn btn-outline-secondary" type="button">Go</button>
</div>

<!-- multiple inputs -->
<div class="input-group">
  <span class="input-group-text">First and last name</span>
  <input type="text" class="form-control">
  <input type="text" class="form-control">
</div>

フローティングラベル

フローティングラベルは、フィールドにフォーカスが当たるか内容があるとき、ラベルが入力内から入力の上へアニメーションします。HTML ではラベルが入力の後に来なければなりません。フローティング動作には placeholder 属性が必須です(空でも)。スペースを節約できモダンな見た目になります。input-group とは組み合わせないでください。フローティングラベルは入力、テキストエリア、セレクトで動きます。コンパクトなフォームでの従来のラベルのきれいな代替です。

bootstrap
<!-- floating label (label floats up when focused/filled) -->
<div class="form-floating mb-3">
  <input type="email" class="form-control" id="floatingInput" placeholder="[email protected]">
  <label for="floatingInput">Email address</label>
</div>

<!-- floating textarea -->
<div class="form-floating">
  <textarea class="form-control" id="floatingTextarea" placeholder="Leave a comment"></textarea>
  <label for="floatingTextarea">Comments</label>
</div>

<!-- floating select -->
<div class="form-floating mb-3">
  <select class="form-select" id="floatingSelect">
    <option selected>Open this select menu</option>
    <option value="1">One</option>
  </select>
  <label for="floatingSelect">Works with selects</label>
</div>

<!-- note: placeholder is REQUIRED for floating labels -->
<!-- the placeholder="..." must be present -->

バリデーション

Bootstrap はバリデーション用のスタイルとして is-valid と is-invalid クラスを提供し、メッセージには valid-feedback と invalid-feedback を使います。フォームに needs-validation クラスを付け、novalidate(ブラウザのツールチップを無効化)と組み合わせれば、カスタム JS で Bootstrap のバリデーション UI を使えます。送信時に was-validated を加えるとすべての検証状態が表示されます。HTML5 の制約(required、pattern、type)やカスタムのサーバー側バリデーションとも連携します。

bootstrap
<!-- server-side validation classes -->
<div class="mb-3">
  <label for="username" class="form-label">Username</label>
  <input type="text" class="form-control is-valid" id="username" value="valid_user">
  <div class="valid-feedback">Looks good!</div>
</div>

<div class="mb-3">
  <label for="email" class="form-label">Email</label>
  <input type="email" class="form-control is-invalid" id="email">
  <div class="invalid-feedback">Please enter a valid email.</div>
</div>

<!-- no validate on form to disable browser validation -->
<form class="needs-validation" novalidate>
  <div class="mb-3">
    <input type="text" class="form-control" required>
    <div class="invalid-feedback">This field is required.</div>
  </div>
  <button class="btn btn-primary" type="submit">Submit</button>
</form>

<!-- JS: form.classList.add('was-validated') on submit -->
07

ボタン

ボタンのバリエーション

btn が基本のボタンクラスで、btn-{color} がバリアントを設定します。塗りつぶしボタンは色付きの背景に白い文字です。アウトラインボタン(btn-outline-*)は背景が透明で文字/罫線に色が付きます — サブの操作に向いています。btn-link はボタンをリンク風に見せます。色は意味を持って選びましょう:confirm は success、削除は danger、注意は warning。色だけで意味を伝えず、必ずテキストも添えましょう。

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

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

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

ボタンのサイズと状態

ボタンのサイズ:btn-lg、デフォルト、btn-sm。disabled 属性(<button> の場合)か .disabled クラス(<a> の場合や属性を使えないとき)でボタンを灰色にします。.active は押された外観を加えます。全幅のボタンには d-grid gap-2 を使います(ボタンが縦に積まれて幅を満たします)。d-md-block で md ブレークポイント以降インラインに戻ります — モバイルで全幅、デスクトップで自動幅に便利です。.disabled クラスは pointer-events: none も設定します。

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

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

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

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

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

ボタングループ

btn-group はボタンを横に並べて縁を連結します。btn-toolbar は間隔付きで複数のグループをまとめます。btn-group-vertical はボタンを縦に積みます。アクセシビリティのため必ず role='group' と aria-label を追加しましょう。サイズクラス(btn-group-lg/sm)はグループ内の全ボタンに適用されます。ボタングループはツールバー、セグメントコントロール、ページネーション風 UI の基礎です。

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

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

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

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

トグルとチェックボックスボタン

btn-check は非表示の checkbox/radio で、トグル動作のために btn ラベルとペアにします。入力は視覚的に隠れ、ラベル(ボタン風に整形)が状態を表示します。単一のトグルには checkbox を、排他的な選択には同じ name の radio を使います。チェックされるとボタンの見た目が変わります。autocomplete='off' でブラウザの状態復元を防ぎます。これがボタン風トグルを作るアクセシブルな方法です。

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

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

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

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

ドロップダウンボタン

ドロップダウンにはトグルボタンに data-bs-toggle='dropdown' が必要です。メニューは dropdown-item を持つ ul.dropdown-menu です。dropdown-divider がグループを区切ります。スプリットボタン(dropdown-toggle-split)はアクションボタンとトグル矢印を分けます — アクセシビリティのため visually-hidden テキストを加えましょう。dropdown-item.active が現在の選択を示し、.disabled は灰色にします。ドロップダウンには Bootstrap JS バンドル(位置決めの Popper を含む)が必要です。

bootstrap
<!-- button dropdown -->
<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button"
          data-bs-toggle="dropdown" aria-expanded="false">
    Dropdown button
  </button>
  <ul class="dropdown-menu">
    <li><a class="dropdown-item" href="#">Action</a></li>
    <li><a class="dropdown-item" href="#">Another action</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><a class="dropdown-item" href="#">Separated link</a></li>
  </ul>
</div>

<!-- split dropdown -->
<div class="btn-group">
  <button type="button" class="btn btn-primary">Primary</button>
  <button type="button" class="btn btn-primary dropdown-toggle dropdown-toggle-split"
          data-bs-toggle="dropdown" aria-expanded="false">
    <span class="visually-hidden">Toggle Dropdown</span>
  </button>
  <ul class="dropdown-menu">...</ul>
</div>

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

カード

基本のカード

カードはヘッダー、ボディ、フッターを持てる柔軟なコンテナです。card-img-top が画像を上部に置き、card-title、card-subtitle、card-text が内容を整形します。幅は親グリッドか style 属性で制御します — カードのデフォルトは全幅です。card-header と card-footer は構造化されたコンテンツ向けです。カードは Bootstrap 3 の panel、well、thumbnail を 1 つの統一コンポーネントに置き換えました。

bootstrap
<div class="card" style="width: 18rem;">
  <!-- optional image -->
  <img src="..." class="card-img-top" alt="...">

  <div class="card-body">
    <h5 class="card-title">Card title</h5>
    <h6 class="card-subtitle mb-2 text-muted">Card subtitle</h6>
    <p class="card-text">Some quick example text to build on the card title.</p>
    <a href="#" class="btn btn-primary">Go somewhere</a>
  </div>
</div>

<!-- card sections -->
<div class="card">
  <div class="card-header">Header</div>
  <div class="card-body">Body content</div>
  <div class="card-footer text-muted">Footer</div>
</div>

カードのコンテンツタイプ

カードにはさまざまなコンテンツが入ります:画像、テキスト、リストグループ(list-group-flush で罫線を取り除きカードの縁に合わせる)、リンク(card-link が間隔を加えます)。card-body、list-group、card-header、card-footer を組み合わせて、必要なカードを正確に作りましょう。list-group-flush は二重罫線なしでリストをカードにシームレスに統合します。この柔軟性により、カードは Bootstrap の最も汎用的なコンポーネントになっています。

bootstrap
<!-- list group inside card -->
<div class="card" style="width: 18rem;">
  <div class="card-header">Featured</div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item">Item 1</li>
    <li class="list-group-item">Item 2</li>
    <li class="list-group-item">Item 3</li>
  </ul>
  <div class="card-body">
    <a href="#" class="card-link">Card link</a>
    <a href="#" class="card-link">Another link</a>
  </div>
</div>

<!-- kitchen sink (all content types) -->
<div class="card">
  <img src="..." class="card-img-top">
  <div class="card-body">
    <h5 class="card-title">Title</h5>
    <p class="card-text">Text</p>
  </div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item">List item</li>
  </ul>
  <div class="card-body">
    <a href="#" class="card-link">Link</a>
  </div>
</div>

カードグリッドとグループ

card-group はカードを共通の罫線と同じ高さで連結します。レスポンシブなカードグリッドにはグリッドシステムを使いましょう:row row-cols-1 row-cols-md-3 g-4 はモバイルで 1 列、デスクトップで 3 列、gap-4 の間隔です。各カードは .col に入ります。グリッドのアプローチの方が card-group より柔軟です — カードは独立した高さを持て、折り返しも制御できます。連結した等高カードが必要なときだけ card-group を使います。

bootstrap
<!-- card group (cards share border, equal height) -->
<div class="card-group">
  <div class="card">
    <img src="..." class="card-img-top">
    <div class="card-body">
      <h5 class="card-title">Card 1</h5>
    </div>
  </div>
  <div class="card">
    <div class="card-body">
      <h5 class="card-title">Card 2</h5>
    </div>
  </div>
  <div class="card">
    <div class="card-body">
      <h5 class="card-title">Card 3</h5>
    </div>
  </div>
</div>
<!-- cards have equal height, connected borders -->

<!-- using grid for responsive card layout -->
<div class="row row-cols-1 row-cols-md-3 g-4">
  <div class="col">
    <div class="card">...</div>
  </div>
  <div class="col">
    <div class="card">...</div>
  </div>
</div>

カードナビゲーション

カードのヘッダーに nav-tabs や nav-pills を置けばナビゲーションを追加できます。card-header-tabs と card-header-pills はナビをヘッダーの縁にフラッシュに統合します。現在のタブには nav-link active、非アクティブには nav-link disabled を使います。タブを機能させ(コンテンツを切り替え)、data-bs-toggle='tab' とタブペインを加えると — Bootstrap の JS が切り替えを処理します。このパターンは複数ビューを持つダッシュボードやコンテンツカードで一般的です。

bootstrap
<!-- card with nav tabs -->
<div class="card text-center">
  <div class="card-header">
    <ul class="nav nav-tabs card-header-tabs">
      <li class="nav-item">
        <a class="nav-link active" href="#">Active</a>
      </li>
      <li class="nav-item">
        <a class="nav-link" href="#">Link</a>
      </li>
      <li class="nav-item">
        <a class="nav-link disabled">Disabled</a>
      </li>
    </ul>
  </div>
  <div class="card-body">
    <h5 class="card-title">Special title</h5>
    <p class="card-text">Content for active tab.</p>
    <a href="#" class="btn btn-primary">Go</a>
  </div>
</div>

<!-- card with pills -->
<div class="card-header">
  <ul class="nav nav-pills card-header-pills">
    <li class="nav-item"><a class="nav-link active" href="#">Active</a></li>
  </ul>
</div>

カードのバリエーションとオーバーレイ

カードの色バリアント:塗りつぶし背景には bg-{color} と text-white/text-dark、色付きの罫線には border-{color} と text-{color}。card-img-overlay はテキストを画像の上に置きます(card-img がカードを満たし、オーバーレイの内容がその上に乗る)— 画像上の読めるテキストには text-bg-dark を使いましょう。text-center/text-start/text-end でテキストの整列を制御します。暗い画像オーバーレイでは、テキストと画像の十分なコントラストを確保してください。

bootstrap
<!-- colored card -->
<div class="card text-white bg-primary">
  <div class="card-header">Header</div>
  <div class="card-body">
    <h5 class="card-title">Primary card</h5>
    <p class="card-text">Text on colored background.</p>
  </div>
</div>

<!-- border colored card -->
<div class="card border-primary">
  <div class="card-header border-primary">Header</div>
  <div class="card-body text-primary">
    <h5 class="card-title">Primary border</h5>
  </div>
</div>

<!-- image overlay (text over image) -->
<div class="card text-bg-dark">
  <img src="..." class="card-img">
  <div class="card-img-overlay">
    <h5 class="card-title">Overlay title</h5>
    <p class="card-text">Text over the image.</p>
  </div>
</div>

<!-- text alignment -->
<div class="card text-center">Centered text</div>
<div class="card text-end">Right-aligned</div>
11

アラート

基本のアラート

アラートは文脈に応じたフィードバックメッセージを表示します。alert-{variant} が色を設定します(primary、success、danger、warning、info、light、dark)。role='alert' はスクリーンリーダーのためです。alert-link はアラートの色に合わせたリンクを整形します。アラートの用途:フォームのバリデーションフィードバック、操作結果(保存しました!削除しました!)、重要なお知らせ。色は意味的に選びます:ポジティブは success、エラーは danger、注意は warning、中立的な情報は info。

bootstrap
<!-- alert variants -->
<div class="alert alert-primary" role="alert">Primary alert</div>
<div class="alert alert-secondary" role="alert">Secondary alert</div>
<div class="alert alert-success" role="alert">Success! Well done.</div>
<div class="alert alert-danger" role="alert">Danger! Something went wrong.</div>
<div class="alert alert-warning" role="alert">Warning! Check this.</div>
<div class="alert alert-info" role="alert">Info! Note this.</div>
<div class="alert alert-light" role="alert">Light alert</div>
<div class="alert alert-dark" role="alert">Dark alert</div>

<!-- with link -->
<div class="alert alert-primary" role="alert">
  This is an alert with <a href="#" class="alert-link">a link</a>.
</div>

閉じられるアラート

alert-dismissible が閉じるボタン用のパディングを加え、data-bs-dismiss='alert' 付きの btn-close で閉じます。fade show でフェードアウトのトランジションが有効になります。閉じるとアラートは DOM から削除されます(隠れるだけではない)。JS では Alert インスタンスを作り close() を呼びます。削除後に closed.bs.alert イベントが発火します。再表示したい場合は DOM 要素を再作成する必要があります。永続的な却下(再表示しない)には状態を localStorage に保存しましょう。

bootstrap
<!-- dismissible alert -->
<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>Holy guacamole!</strong> You should check in on some of those fields.
  <button type="button" class="btn-close" data-bs-dismiss="alert"
          aria-label="Close"></button>
</div>

<!-- needs these classes:
     - alert-dismissible: adds padding for close button
     - fade show: enables transition

<!-- after dismissal, the alert is removed from DOM -->

<!-- via JavaScript -->
<script>
const alertEl = document.querySelector('.alert')
const alert = new bootstrap.Alert(alertEl)
alert.close()  // closes and removes
</script>

<!-- events -->
alertEl.addEventListener('closed.bs.alert', () => {
  console.log('alert was closed and removed')
})
</script>

アイコンとコンテンツ付きアラート

アラートにはリッチなコンテンツが入ります:見出し(alert-heading)、段落、区切り線(hr)、アイコン、アクションボタン。アイコンには Bootstrap Icons(bi クラス)か、flex 整列で SVG を使います。d-flex align-items-center でアイコンとテキストを垂直中央にそろえます。閉じるボタンの横にアクションボタン(セッション警告の「延長」など)を入れましょう。アラートはテキスト専用ではなく — 重要で閉じられるフィードバックのための柔軟なコンテナです。

bootstrap
<!-- alert with icon -->
<div class="alert alert-success d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" width="24" height="24">
    <use xlink:href="#check-circle-fill"/>
  </svg>
  <div>
    Operation completed successfully!
  </div>
</div>

<!-- alert with more content -->
<div class="alert alert-danger" role="alert">
  <h4 class="alert-heading">Error!</h4>
  <p>There was a problem processing your request.</p>
  <hr>
  <p class="mb-0">Please try again or contact support.</p>
</div>

<!-- alert with action button -->
<div class="alert alert-warning alert-dismissible" role="alert">
  Your session expires in 5 minutes.
  <button type="button" class="btn btn-warning btn-sm ms-3">
    Extend
  </button>
  <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
</div>

トースト通知

トーストは軽量な通知です(Android のトーストのように)。遅延の後に自動で隠れます(デフォルト 5 秒)。積み重ねには toast-container で包み、position-fixed と top-0 end-0 で右上に固定します。aria-live='assertive' がスクリーンリーダーに読み上げます。toast-header にはアイコン、タイトル、タイムスタンプ、閉じるボタン、toast-body にはメッセージを置きます。アラートと違いトーストは UI をブロックしません — 非侵入的です。「保存しました!」「新着メッセージ」、バックグラウンドタスクの完了に使いましょう。

bootstrap
<!-- toast container (top-right by default) -->
<div class="toast-container position-fixed top-0 end-0 p-3">
  <div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
    <div class="toast-header">
      <img src="..." class="rounded me-2" width="20">
      <strong class="me-auto">Bootstrap</strong>
      <small>11 mins ago</small>
      <button type="button" class="btn-close" data-bs-dismiss="toast"></button>
    </div>
    <div class="toast-body">
      Hello, world! This is a toast message.
    </div>
  </div>
</div>

<script>
// show via JS
const toastEl = document.querySelector('.toast')
const toast = new bootstrap.Toast(toastEl, {
  delay: 5000,       // auto-hide after 5s
  autohide: true
})
toast.show()

// events
toastEl.addEventListener('shown.bs.toast', () => {
  console.log('toast visible')
})
</script>

ライブアラート領域

動的に更新されるアラート(ステータスメッセージ、進捗)には aria-live='polite' を使いましょう — スクリーンリーダーが中断せずに変更を読み上げます。aria-live='assertive' は即座に読み上げます(重大なエラー用)。aria-atomic='true' は変更時に全体を読みます(変更部分だけではない)。role='alert' は暗黙的に assertive です。このアクセシビリティパターンにより、スクリーンリーダーのユーザーも動的な更新を聞けます。見た目のスタイリングには alert クラスと組み合わせましょう。

bootstrap
<!-- aria-live for dynamic alerts -->
<div class="alert alert-info" role="alert" aria-live="polite"
     aria-atomic="true" id="statusAlert">
  <!-- content updated dynamically -->
</div>

<script>
// update alert content
function showStatus(message, type = 'info') {
  const alert = document.getElementById('statusAlert')
  alert.className = 'alert alert-' + type
  alert.textContent = message
}

showStatus('Loading...', 'info')
// later:
showStatus('Data loaded!', 'success')

<!-- aria-live="polite" announces updates without interrupting -->
<!-- aria-live="assertive" interrupts immediately (urgent) -->

<!-- for form errors, use role="alert" (assertive by default) -->
<div role="alert" class="alert alert-danger" id="formError">
  Please fix the errors below.
</div>
</script>
12

バッジ

基本のバッジ

バッジは小さな数値/ラベル表示です。bg-{color} が背景を設定し、明るい背景(warning、info、light)には対比のため text-dark を加えます。バッジは親要素のフォントサイズに相対的にスケールします — h1 のバッジは p のバッジより大きい。バッジの用途:未読数、ステータスラベル、「新着」タグ、バージョン番号。テキストの流れの中に収まるインライン要素です。

bootstrap
<!-- inline badges -->
<h1>Heading <span class="badge bg-secondary">New</span></h1>
<h2>Heading <span class="badge bg-secondary">New</span></h2>
<h3>Heading <span class="badge bg-secondary">New</span></h3>

<!-- colored badges -->
<span class="badge bg-primary">Primary</span>
<span class="badge bg-secondary">Secondary</span>
<span class="badge bg-success">Success</span>
<span class="badge bg-danger">Danger</span>
<span class="badge bg-warning text-dark">Warning</span>
<span class="badge bg-info text-dark">Info</span>
<span class="badge bg-light text-dark">Light</span>
<span class="badge bg-dark">Dark</span>

<!-- badge sizing scales with parent -->
<h1>Big <span class="badge bg-primary">Badge</span></h1>
<p>Small <span class="badge bg-primary">Badge</span></p>

ピルバッジと角丸

rounded-pill は完全に丸いバッジ(ピル形状)を作ります。rounded-0〜rounded-3 が角丸の段階を制御します。rounded-circle にパディングを加えると円形のバッジになります — 通知数に有用です。1 桁の完全な円には、同じ幅/高さを設定し d-flex align-items-center justify-content-center を使います。ピルバッジはタグやステータス表示によく使われます。

bootstrap
<!-- pill badges (more rounded) -->
<span class="badge rounded-pill bg-primary">Primary</span>
<span class="badge rounded-pill bg-success">Success</span>
<span class="badge rounded-pill bg-danger">Danger</span>

<!-- rounded variations -->
<span class="badge rounded-0 bg-primary">Not rounded</span>
<span class="badge rounded-1 bg-primary">Slightly rounded</span>
<span class="badge rounded-2 bg-primary">Default rounded</span>
<span class="badge rounded-3 bg-primary">More rounded</span>
<span class="badge rounded-pill bg-primary">Full pill</span>

<!-- circle badge (fixed size, centered text) -->
<span class="badge rounded-circle bg-primary p-2">5</span>
<!-- needs width/height for perfect circle -->

ボタンとナビの中のバッジ

ボタン内のバッジ:ボタンに position-relative、バッジに position-absolute と top-0 start-100 translate-middle を付けると右上の角に配置できます。バッジ内の visually-hidden テキストがスクリーンリーダーに文脈を与えます。ナビリンクやリスト項目内のバッジは数を表示します — 右へ押すには justify-content-between を使いましょう。数が表示上限を超えるときの「99+」パターンはよく使われます。

bootstrap
<!-- badge inside button -->
<button type="button" class="btn btn-primary position-relative">
  Inbox
  <span class="position-absolute top-0 start-100 translate-middle
               badge rounded-pill bg-danger">
    99+
  </span>
</button>

<!-- badge with position outside button -->
<button class="btn btn-primary position-relative">
  Messages
  <span class="position-absolute top-0 start-100 translate-middle
               badge rounded-pill bg-danger">
    9
    <span class="visually-hidden">unread messages</span>
  </span>
</button>

<!-- badge in nav link -->
<ul class="nav nav-pills">
  <li class="nav-item">
    <a class="nav-link" href="#">
      Profile
      <span class="badge bg-secondary">3</span>
    </a>
  </li>
</ul>

<!-- badge in list item -->
<li class="list-group-item d-flex justify-content-between align-items-center">
  Messages
  <span class="badge bg-primary rounded-pill">14</span>
</li>

バッジインジケーター(ドット)

ドットバッジ(テキストなし、色付きの円だけ)は数なしで状態を示します — 「未読」や「オンライン」のような。小さなドットには p-1 と rounded-circle、背景から分離するには border-light を使いましょう。位置は同じ translate-middle 手法で。オンライン状態のドット(緑 = オンライン、グレー = オフライン)はアバターの下の角に置きます。バッジはアイコンを囲むこともできます(Bootstrap Icons:bi bi-star-fill)— 評価用のテキスト付きで。

bootstrap
<!-- status dot badge -->
<button class="btn btn-primary position-relative">
  Notifications
  <span class="position-absolute top-0 start-100 translate-middle
               p-1 bg-danger border border-light rounded-circle">
    <span class="visually-hidden">New alerts</span>
  </span>
</button>

<!-- small dot (no text, just indicator) -->
<span class="position-absolute top-0 start-100 translate-middle
             p-1 bg-danger border border-light rounded-circle"></span>

<!-- online status indicator -->
<span class="position-relative d-inline-flex">
  <img src="avatar.jpg" class="rounded-circle" width="40">
  <span class="position-absolute bottom-0 end-0
               bg-success border border-light rounded-circle p-1">
  </span>
</span>
<!-- green dot = online -->

<!-- badge with icon -->
<span class="badge bg-primary">
  <i class="bi bi-star-fill"></i> 4.5
</span>

スピナーボーダーとグロー

スピナーはローディング状態を示します。spinner-border は回転するリング、spinner-grow は脈動する円です。text-* で色を付けます。spinner-border-sm/grow-sm は小型版です。カスタムサイズは width/height の CSS で。アクセシビリティのため必ず role='status' と visually-hidden テキストを含めましょう。ボタン内では、spinner-border-sm と disabled を組み合わせて読み込み中の操作を示します。スピナーは CSS のみで動きます(JS 不要)— border と opacity のトランジションでアニメーションします。

bootstrap
<!-- border spinner (rotating border) -->
<div class="spinner-border" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

<!-- colored spinner -->
<div class="spinner-border text-primary"></div>
<div class="spinner-border text-success"></div>
<div class="spinner-border text-danger"></div>

<!-- grow spinner (pulsating circle) -->
<div class="spinner-grow" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

<!-- sizes -->
<div class="spinner-border spinner-border-sm">Small</div>
<div class="spinner-grow spinner-grow-sm">Small grow</div>

<!-- custom size via CSS -->
<div class="spinner-border" style="width: 3rem; height: 3rem;"></div>

<!-- spinner in button -->
<button class="btn btn-primary" disabled>
  <span class="spinner-border spinner-border-sm"></span>
  Loading...
</button>

<!-- spinner with text -->
<div class="d-flex align-items-center">
  <strong>Loading...</strong>
  <div class="spinner-border ms-auto"></div>
</div>
13

プログレスとスピナー

基本のプログレスバー

プログレスバーはタスクの完了を示します。幅はインラインスタイルでパーセンテージとして設定します。role='progressbar' と aria-valuenow/min/max はアクセシビリティのためです。高さは .progress コンテナに設定します(デフォルト 1rem)。バーの bg-{color} で色が変わります。バーの中のラベルテキストはオプションです — ミニマルなバーなら省略できます。値が動的なため、幅は必ずスタイルで設定し(クラスではなく)。

bootstrap
<!-- basic progress bar -->
<div class="progress">
  <div class="progress-bar" role="progressbar" style="width: 50%"
       aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
    50%
  </div>
</div>

<!-- without label -->
<div class="progress">
  <div class="progress-bar" style="width: 75%" role="progressbar"
       aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
</div>

<!-- height (set on container) -->
<div class="progress" style="height: 1px;">
  <div class="progress-bar" style="width: 25%"></div>
</div>
<div class="progress" style="height: 20px;">
  <div class="progress-bar" style="width: 25%"></div>
</div>

<!-- background -->
<div class="progress">
  <div class="progress-bar bg-success" style="width: 25%">25%</div>
</div>

縞模様とアニメーション付きプログレス

progress-bar-striped が斜めの縞模様を加えます。progress-bar-animated は縞模様を動かします(実行中/進行中のタスク向け)。アニメーションは現在実行中のタスクだけに使い、完了したタスクには静的なバーを。進捗の更新は JS で style.width と aria-valuenow を変えて行います。アニメーションは CSS で動きます — 動きに JS は不要です。色付きの縞模様バーには bg-* と striped を組み合わせましょう。

bootstrap
<!-- striped progress bar -->
<div class="progress">
  <div class="progress-bar progress-bar-striped" style="width: 50%">
    50%
  </div>
</div>

<!-- animated stripes (for in-progress tasks) -->
<div class="progress">
  <div class="progress-bar progress-bar-striped progress-bar-animated"
       style="width: 75%" role="progressbar">
    75%
  </div>
</div>

<!-- colored striped -->
<div class="progress">
  <div class="progress-bar progress-bar-striped bg-success" style="width: 100%">
    Complete
  </div>
</div>

<!-- update via JS -->
<div class="progress">
  <div class="progress-bar" id="myBar" style="width: 0%"></div>
</div>
<script>
const bar = document.getElementById('myBar')
bar.style.width = '60%'  // update progress
bar.setAttribute('aria-valuenow', '60')
</script>

複数のプログレスバー

1 つの .progress コンテナ内の複数の progress-bar div は横に並びます — それぞれが総幅の割合を取ります。構成を表示するのに有用です(例:ストレージ:写真 25%、動画 30%、アプリ 20%)。バーは同じ高さを共有し、隙間なく隣接します。合計は理想的には 100%(未満なら未完了を意味します)。それぞれに独自の色とラベルを付けられます。

bootstrap
<!-- stacked bars in one container -->
<div class="progress">
  <div class="progress-bar" style="width: 15%">15%</div>
  <div class="progress-bar bg-success" style="width: 30%">30%</div>
  <div class="progress-bar bg-info" style="width: 20%">20%</div>
</div>
<!-- total: 65% filled, 35% empty -->

<!-- stacked with different colors -->
<div class="progress" style="height: 30px;">
  <div class="progress-bar bg-danger" style="width: 25%">Errors</div>
  <div class="progress-bar bg-warning" style="width: 25%">Warnings</div>
  <div class="progress-bar bg-success" style="width: 50%">Success</div>
</div>

<!-- each bar takes its percentage of the full width -->
<!-- they sit side by side, not overlapping -->

プレースホルダーローディング

プレースホルダー(スケルトンロードーディング)は、コンテンツが現れる場所にグレーのブロックを表示します — コンテンツの多いページではスピナーより優れています。placeholder-glow は脈動するきらめきを、placeholder-wave は動く波を作ります。col-* が各ブロックの幅を設定します。スケルトンカードには、card コンポーネント内に aria-hidden='true' 付きの placeholder を使いましょう。データ読み込み前にレイアウトのプレビューを示し、体感待ち時間を減らせます。

bootstrap
<!-- placeholder (gray animated blocks) -->
<div class="placeholder-glow">
  <span class="placeholder col-12"></span>
  <span class="placeholder col-12"></span>
  <span class="placeholder col-8"></span>
</div>

<!-- wave animation -->
<div class="placeholder-wave">
  <span class="placeholder col-12"></span>
</div>

<!-- placeholder card (skeleton loading) -->
<div class="card" aria-hidden="true">
  <div class="card-body">
    <h5 class="card-title placeholder-glow">
      <span class="placeholder col-6"></span>
    </h5>
    <p class="card-text placeholder-glow">
      <span class="placeholder col-7"></span>
      <span class="placeholder col-4"></span>
      <span class="placeholder col-4"></span>
      <span class="placeholder col-6"></span>
    </p>
    <a class="btn btn-primary disabled placeholder col-6"></a>
  </div>
</div>

レンジスライダー

form-range はネイティブの range 入力(スライダー)を整形します。範囲と刻みには min、max、step 属性を設定します。スライダーはデフォルトで全幅です。値の表示には、oninput でユーザーがドラッグ中にラベルを更新しましょう。disabled で灰色にできます。レンジ入力は音量、不透明度、正確さを要しない連続値に向いています。アクセシビリティのため必ずラベルとペアにしましょう。

bootstrap
<!-- range input -->
<label for="customRange1" class="form-label">Example range</label>
<input type="range" class="form-range" id="customRange1" min="0" max="5" step="0.5">

<!-- with value display -->
<div class="d-flex">
  <input type="range" class="form-range me-2" id="range"
         min="0" max="100" oninput="document.getElementById('val').textContent = this.value">
  <span id="val" class="badge bg-primary">50</span>
</div>

<!-- disabled -->
<input type="range" class="form-range" disabled>

<!-- min, max, step -->
<input type="range" class="form-range" min="-10" max="10" step="2" value="0">
14

ユーティリティクラス

スペーシング(マージンとパディング)

スペーシングユーティリティは {property}{sides}-{size} の形式です。m = margin、p = padding。辺:t/b(上/下)、s/e(start/end — LTR では左/右)、x(左 + 右)、y(上 + 下)、空欄(すべて)。サイズ 0〜5 はスペーシングスケールに対応します(0、0.25rem、0.5rem、1rem、1.5rem、3rem)。mx-auto はブロック要素を中央寄せします。レスポンシブにはブレークポイントを加えます(mt-md-3)。Bootstrap 5 は RTL 対応のため left/right を start/end に改名しました。

bootstrap
<!-- format: {property}{sides}-{size} -->
<!-- property: m (margin), p (padding) -->
<!-- sides: t (top), b (bottom), s (start/left), e (end/right), x (both), y (both), blank (all) -->
<!-- size: 0, 1, 2, 3, 4, 5, auto -->

<div class="mt-3">margin-top: 1rem</div>
<div class="mb-4">margin-bottom: 1.5rem</div>
<div class="ms-2">margin-left: 0.5rem (start)</div>
<div class="me-2">margin-right: 0.5rem (end)</div>
<div class="mx-auto">margin: 0 auto (centered)</div>
<div class="my-5">margin top+bottom: 3rem</div>

<div class="p-3">padding: 1rem (all sides)</div>
<div class="px-4">padding left+right: 1.5rem</div>
<div class="pt-2">padding-top: 0.5rem</div>

<!-- responsive: {property}{sides}-{breakpoint}-{size} -->
<div class="mt-0 mt-md-3">No margin on mobile, 1rem on md+</div>
<div class="p-2 p-lg-4">Small padding, larger on lg+</div>

色と背景

text-{color} が文字色を、bg-{color} が背景を設定します。text-bg-{color}(Bootstrap 5.2+)は背景に合わせて自動的に対比する文字色を設定します。bg-gradient が控えめなグラデーションを加えます。不透明度:text-opacity-50 か bg-opacity-50(10%、25%、50%、75%、100%)。text-muted はグレー(二次テキスト)です。文字と背景の十分なコントラストを常に確保しましょう — ダーク背景には text-white。色は意味を持っています(success = 緑、danger = 赤)。

bootstrap
<!-- text colors -->
<p class="text-primary">Primary text</p>
<p class="text-success">Success text</p>
<p class="text-danger">Danger text</p>
<p class="text-muted">Muted text</p>
<p class="text-white bg-dark">White on dark</p>

<!-- background colors -->
<div class="bg-primary text-white">Primary bg</div>
<div class="bg-success text-white">Success bg</div>
<div class="bg-light">Light bg</div>
<div class="bg-dark text-white">Dark bg</div>

<!-- gradient background -->
<div class="bg-primary bg-gradient text-white p-3">
  Gradient background
</div>

<!-- opacity -->
<div class="text-primary text-opacity-50">50% opacity text</div>
<div class="bg-primary bg-opacity-50">50% opacity bg</div>

<!-- text color with background theme -->
<div class="text-bg-primary">Primary (auto text color)</div>

Display と Flexbox

d-* が display プロパティを設定します(d-none は要素を隠す)。レスポンシブの d-{breakpoint}-* はブレークポイントで display を変えます — d-none d-md-block はモバイルで非表示、デスクトップで表示です。d-flex で flexbox が有効になり、flex-direction、justify-content-*、align-items-*、flex-wrap が flex レイアウトを制御します。これらのユーティリティはレイアウトのためのカスタム CSS の大部分を置き換えます。d-md-flex は md 以降のみ flex を有効にします。メディアクエリなしで複雑なレスポンシブレイアウトを組み合わせられます。

bootstrap
<!-- display utilities -->
<div class="d-none">display: none</div>
<div class="d-inline">display: inline</div>
<div class="d-inline-block">display: inline-block</div>
<div class="d-block">display: block</div>
<div class="d-flex">display: flex</div>
<div class="d-inline-flex">display: inline-flex</div>

<!-- responsive display -->
<div class="d-none d-md-block">Hidden on mobile, block on md+</div>
<div class="d-block d-md-none">Visible only below md</div>

<!-- flex direction -->
<div class="d-flex flex-column">Column</div>
<div class="d-flex flex-row-reverse">Reversed row</div>

<!-- justify content -->
<div class="d-flex justify-content-center">Center</div>
<div class="d-flex justify-content-between">Space between</div>
<div class="d-flex justify-content-around">Space around</div>

<!-- align items -->
<div class="d-flex align-items-center">Vertically centered</div>
<div class="d-flex align-items-end">Bottom aligned</div>

<!-- flex wrap -->
<div class="d-flex flex-wrap">Wrap</div>
<div class="d-flex flex-nowrap">No wrap</div>

Position とフロート

position-* が CSS position を設定します。position-sticky と top-0 でスティッキーヘッダーを作れます(スクロールで固定)。top/bottom/start/end(0 か 50%)が内側へのオフセットを設定し、translate-middle が要素を中央に置きます(top-50 start-50 と組み合わせて完全に中央)。フロート(float-start/end)はレガシーです — レイアウトには flexbox を使いましょう。clearfix がフロートした子を片付け、fixed-top/fixed-bottom は要素をビューポートに固定します。ナビバーには sticky が推奨です — 初期状態でコンテンツに重なりません。

bootstrap
<!-- position -->
<div class="position-static">Static (default)</div>
<div class="position-relative">Relative (offset parent)</div>
<div class="position-absolute">Absolute</div>
<div class="position-fixed">Fixed (viewport)</div>
<div class="position-sticky top-0">Sticky (sticks at top)</div>

<!-- positioning with insets -->
<div class="position-absolute top-0 start-0">Top-left</div>
<div class="position-absolute top-0 end-0">Top-right</div>
<div class="position-absolute bottom-0 start-50">Bottom-center</div>

<!-- center with translate -->
<div class="position-absolute top-50 start-50 translate-middle">
  Perfectly centered
</div>

<!-- floats (use flexbox instead when possible) -->
<div class="float-start">Float left</div>
<div class="float-end">Float right</div>
<div class="clearfix">Clear floats</div>

<!-- fixed top/bottom -->
<div class="fixed-top">Pinned to top</div>
<div class="fixed-bottom">Pinned to bottom</div>

罫線、シャドウ、角丸

border は特定の辺に罫線を加えたり取り除いたりします。border-{color} で色を付け、border-{1-5} で幅を設定します。rounded-* が角丸を制御:rounded-0(なし)、rounded(デフォルト)、rounded-3(大きめ)、rounded-pill(カプセル)、rounded-circle(50%)。rounded-{side} は特定の角だけ丸めます。shadow-* がボックスシャドウを加えます:none、sm、デフォルト、lg。シャドウは深みを加えます — 控えめな浮き上がりには shadow-sm、モーダル/フローティング要素には shadow-lg。これらのユーティリティでカスタム CSS なしに大半の見た目を扱えます。

bootstrap
<!-- borders -->
<div class="border">All borders</div>
<div class="border-top">Top only</div>
<div class="border border-0">No borders</div>
<div class="border-top-0">Remove top</div>

<!-- border color -->
<div class="border border-primary">Primary border</div>
<div class="border border-danger">Danger border</div>

<!-- border width -->
<div class="border border-2">2px border</div>
<div class="border border-4">4px border</div>

<!-- border radius -->
<div class="rounded">Default radius</div>
<div class="rounded-0">No radius</div>
<div class="rounded-3">Larger radius</div>
<div class="rounded-pill">Pill shape</div>
<div class="rounded-circle">Circle</div>
<div class="rounded-top">Top corners only</div>

<!-- shadows -->
<div class="shadow-none">No shadow</div>
<div class="shadow-sm">Small shadow</div>
<div class="shadow">Regular shadow</div>
<div class="shadow-lg">Large shadow</div>
15

画像と Figure

レスポンシブ画像

img-fluid は画像をレスポンシブにします(max-width: 100%、height: auto)— コンテナからはみ出しません。w-100 は強制的に全幅にします。figure/figure-img/figure-caption はキャプション付き画像のセマンティックな構造を提供します(div + p より優れています)。float-start/end で画像を整列し、mx-auto d-block で中央寄せ、rounded で角丸を加えます。アクセシビリティのため必ず alt テキストを付けましょう — スクリーンリーダーのために画像を説明します。装飾的な画像には alt='' を。

bootstrap
<!-- responsive image (scales with parent) -->
<img src="photo.jpg" class="img-fluid" alt="Responsive image">
<!-- max-width: 100%; height: auto; -->

<!-- full-width image -->
<img src="banner.jpg" class="img-fluid w-100" alt="Banner">

<!-- image with figure -->
<figure class="figure">
  <img src="photo.jpg" class="figure-img img-fluid rounded" alt="...">
  <figcaption class="figure-caption text-end">
    A caption for the image.
  </figcaption>
</figure>

<!-- image alignment -->
<img src="..." class="rounded float-start" alt="Left">
<img src="..." class="rounded float-end" alt="Right">
<img src="..." class="rounded mx-auto d-block" alt="Centered">

<!-- center with text-center on parent -->
<div class="text-center">
  <img src="..." class="rounded" alt="Centered">
</div>

画像の形状とサムネイル

画像の形状:rounded(角丸)、rounded-circle(円形 — 正方形の画像に最適)、rounded-pill(カプセル)。img-thumbnail は罫線、パディング、角丸を加えます — 写真プリントのような見た目に。円形サムネイルには img-thumbnail と rounded-circle を組み合わせましょう。アバターでは、レイアウトシフトを防ぐため明示的な width/height を設定してスペースを確保します。形状クラスは画像だけでなく任意の要素に使えます — 動画のサムネイルやプロフィール画像に有用です。

bootstrap
<!-- rounded corners -->
<img src="..." class="rounded" alt="Rounded">

<!-- fully rounded (circle) -->
<img src="..." class="rounded-circle" alt="Circle">

<!-- thumbnail (border + padding) -->
<img src="..." class="img-thumbnail" alt="Thumbnail">
<!-- adds padding, border, rounded corners -->

<!-- pill shape -->
<img src="..." class="rounded-pill" alt="Pill">

<!-- combination: thumbnail + circle -->
<img src="..." class="img-thumbnail rounded-circle" alt="Circle thumb">

<!-- avatar sizes (set width/height) -->
<img src="avatar.jpg" class="rounded-circle" width="40" height="40" alt="Avatar">
<img src="avatar.jpg" class="rounded-circle" width="100" height="100" alt="Large avatar">

Figure とキャプション

figure はキャプション付き画像のためのセマンティックな HTML 要素です — div よりアクセシビリティに優れます。figure-img が画像を整形し(img-fluid と rounded と組み合わせる)、figure-caption がキャプションのテキストを整形します(デフォルトで控えめ)。text-start/center/end でキャプションを整列します。クリックで拡大できるようにするには画像を <a> で包みましょう。Figure は編集コンテンツ、ドキュメント、ギャラリーにとって正しいセマンティックな選択です。

bootstrap
<!-- figure with caption -->
<figure class="figure">
  <img src="photo.jpg" class="figure-img img-fluid rounded" alt="Photo">
  <figcaption class="figure-caption">
    Caption describing the image.
  </figcaption>
</figure>

<!-- right-aligned caption -->
<figure class="figure">
  <img src="photo.jpg" class="figure-img img-fluid rounded" alt="Photo">
  <figcaption class="figure-caption text-end">
    Right-aligned caption.
  </figcaption>
</figure>

<!-- centered caption -->
<figcaption class="figure-caption text-center">Centered</figcaption>

<!-- figure with link -->
<figure class="figure">
  <a href="full-size.jpg">
    <img src="thumb.jpg" class="figure-img img-fluid rounded" alt="Click to enlarge">
  </a>
  <figcaption class="figure-caption">Click to view full size</figcaption>
</figure>

背景画像

Bootstrap には背景画像のユーティリティがない(画像はコンテンツに依存する)ため、インラインスタイルを使います。background-size: cover が歪みなくコンテナを満たし、background-position: center が中央に合わせます。画像の上のテキストには、読みやすさのためグラデーションのオーバーレイ(下部が暗い)を加えましょう。position-absolute のレイヤーを position-relative のラッパーに置けば、画像、オーバーレイ、テキストを重ねられます。ヒーローセクションと画像カードの定番パターンです。

bootstrap
<!-- background image via inline style -->
<div style="background-image: url('bg.jpg');
            background-size: cover;
            background-position: center;
            height: 400px;">
  <div class="d-flex align-items-center justify-content-center h-100">
    <h1 class="text-white">Hero text over image</h1>
  </div>
</div>

<!-- parallax-like fixed background -->
<div style="background-image: url('bg.jpg');
            background-attachment: fixed;
            background-size: cover;
            height: 300px;">
</div>

<!-- gradient overlay for text readability -->
<div class="position-relative">
  <img src="bg.jpg" class="img-fluid" alt="">
  <div class="position-absolute top-0 start-0 w-100 h-100"
       style="background: linear-gradient(to bottom, transparent, rgba(0,0,0,0.7));">
  </div>
  <div class="position-absolute bottom-0 start-0 p-4 text-white">
    <h2>Text over gradient</h2>
  </div>
</div>

画像グリッドとギャラリー

画像グリッドは標準の row/col システムを使い、ガターには g-* を使います。アスペクト比に関係なく等高の画像にするには、固定高のコンテナを設定し、img に w-100 h-100 で object-fit: cover を使いましょう。row-cols-* は各アイテムに col-* を指定せずに等幅の列を作ります。本物の masonry(高さ可変、隙間なし)には CSS columns か JavaScript ライブラリが必要です — Bootstrap のグリッドは masonry をネイティブにしません。img-fluid により画像はグリッドセルからはみ出しません。

bootstrap
<!-- responsive image grid -->
<div class="row g-2">
  <div class="col-6 col-md-4">
    <img src="1.jpg" class="img-fluid rounded" alt="">
  </div>
  <div class="col-6 col-md-4">
    <img src="2.jpg" class="img-fluid rounded" alt="">
  </div>
  <div class="col-6 col-md-4">
    <img src="3.jpg" class="img-fluid rounded" alt="">
  </div>
  <div class="col-6 col-md-4">
    <img src="4.jpg" class="img-fluid rounded" alt="">
  </div>
</div>

<!-- equal-height images with object-fit -->
<div class="row g-3">
  <div class="col-md-4">
    <div style="height: 200px;">
      <img src="tall.jpg" class="w-100 h-100"
           style="object-fit: cover;" alt="">
    </div>
  </div>
</div>

<!-- masonry-like with columns -->
<div class="row row-cols-1 row-cols-md-3 g-3">
  <div class="col"><img src="1.jpg" class="img-fluid rounded"></div>
  <div class="col"><img src="2.jpg" class="img-fluid rounded"></div>
</div>
17

Collapse とアコーディオン

基本の Collapse

Collapse は高さのアニメーションで要素の表示をトグルします。トリガー:data-bs-toggle='collapse' と、折りたたむ要素の id を指す data-bs-target(ボタン)か href(アンカー)。.collapse は非表示で、.collapse.show は表示です。トリガーの aria-expanded が状態を反映し、aria-controls がトリガーとターゲットを結びます。操作にはボタン、ナビゲーションにはアンカーを使いましょう。アニメーションは高さを 0 から auto へ滑らかに遷移させます。

bootstrap
<!-- collapse trigger (button) -->
<p>
  <button class="btn btn-primary" type="button"
          data-bs-toggle="collapse" data-bs-target="#collapseExample"
          aria-expanded="false" aria-controls="collapseExample">
    Toggle collapse
  </button>
</p>
<div class="collapse" id="collapseExample">
  <div class="card card-body">
    This content is hidden by default and shown when the button is clicked.
  </div>
</div>

<!-- collapse via anchor -->
<a class="btn btn-primary" data-bs-toggle="collapse"
   href="#collapseExample2" role="button" aria-expanded="false"
   aria-controls="collapseExample2">
  Link trigger
</a>
<div class="collapse" id="collapseExample2">
  <div class="card card-body">Content</div>
</div>

<!-- shown by default -->
<div class="collapse show" id="alwaysShown">
  <div class="card card-body">Shown initially</div>
</div>

アコーディオン

アコーディオンは collapse のグループで、data-bs-parent により 1 つだけ開くことができます(1 つを開くと他が閉じる)。構造:accordion > accordion-item > accordion-header(accordion-button 付き)+ accordion-collapse(accordion-body 付き)。最初の項目に 'show' クラスを付けると開いた状態で始まります。ボタンの 'collapsed' クラスが折りたたみ状態を示します(矢印が回転)。aria-expanded と aria-controls はアクセシビリティに不可欠です。parent 属性が排他オープンの動作を作ります。

bootstrap
<div class="accordion" id="accordionExample">
  <div class="accordion-item">
    <h2 class="accordion-header" id="headingOne">
      <button class="accordion-button" type="button"
              data-bs-toggle="collapse" data-bs-target="#collapseOne"
              aria-expanded="true" aria-controls="collapseOne">
        Accordion Item #1
      </button>
    </h2>
    <div id="collapseOne" class="accordion-collapse collapse show"
         aria-labelledby="headingOne" data-bs-parent="#accordionExample">
      <div class="accordion-body">
        <strong>First item content.</strong> Shown by default.
      </div>
    </div>
  </div>

  <div class="accordion-item">
    <h2 class="accordion-header" id="headingTwo">
      <button class="accordion-button collapsed" type="button"
              data-bs-toggle="collapse" data-bs-target="#collapseTwo"
              aria-expanded="false" aria-controls="collapseTwo">
        Accordion Item #2
      </button>
    </h2>
    <div id="collapseTwo" class="accordion-collapse collapse"
         aria-labelledby="headingTwo" data-bs-parent="#accordionExample">
      <div class="accordion-body">
        <strong>Second item content.</strong>
      </div>
    </div>
  </div>
</div>

アコーディオンの Flush とバリエーション

accordion-flush は外側の罫線と背景を取り除きます — カードやコンテナへの組み込み時に二重罫線を避けられます。collapse 項目に data-bs-parent がなければ、複数のセクションを同時に開けられます(always-open モード)。data-bs-parent があれば、1 つを開くと他が閉じます(標準のアコーディオン)。UX で選びましょう:FAQ など 1 つずつ読むなら排他的(1 つ開く)、ユーザーがセクションを比較できるナビゲーションや設定なら複数開放。

bootstrap
<!-- flush (no borders, no background) -->
<div class="accordion accordion-flush" id="accordionFlush">
  <div class="accordion-item">
    <h2 class="accordion-header">
      <button class="accordion-button collapsed" data-bs-toggle="collapse"
              data-bs-target="#flush1">
        Item #1
      </button>
    </h2>
    <div id="flush1" class="accordion-collapse collapse">
      <div class="accordion-body">Flush content</div>
    </div>
  </div>
</div>
<!-- flush removes outer borders and background -->

<!-- always-open (no exclusive behavior) -->
<div class="accordion" id="accordionAlwaysOpen">
  <div class="accordion-item">
    <h2 class="accordion-header">
      <button class="accordion-button" data-bs-toggle="collapse"
              data-bs-target="#open1">
        Item #1
      </button>
    </h2>
    <div id="open1" class="accordion-collapse collapse show">
      <!-- no data-bs-parent = stays open when others open -->
      <div class="accordion-body">Content</div>
    </div>
  </div>
</div>

JavaScript による Collapse 制御

JS で collapse を制御します:new bootstrap.Collapse(el, options)。toggle: false で初期化時の自動トグルを防ぎ、parent: selector でアコーディオン動作(兄弟を閉じる)を作れます。メソッド:show()、hide()、toggle()、dispose()。イベント:show/shown/hide/hidden.bs.collapse — 入力へのフォーカスや aria 更新のような、アニメーション後の処理には shown/hidden(完了形)を使います。URL ハッシュやフォームの状態に基づいてセクションを展開するようなプログラム的制御に有用です。

bootstrap
<div class="collapse" id="jsCollapse">
  <div class="card card-body">Content</div>
</div>

<script>
const collapseEl = document.getElementById('jsCollapse')
const collapse = new bootstrap.Collapse(collapseEl, {
  toggle: false,      // don't toggle on init
  parent: null        // or selector for accordion behavior
})

// methods
collapse.show()
collapse.hide()
collapse.toggle()

// dispose (removes instance)
collapse.dispose()

// events
collapseEl.addEventListener('show.bs.collapse', () => {
  console.log('about to show')
})
collapseEl.addEventListener('shown.bs.collapse', () => {
  console.log('fully shown')
})
collapseEl.addEventListener('hide.bs.collapse', () => {
  console.log('about to hide')
})
collapseEl.addEventListener('hidden.bs.collapse', () => {
  console.log('fully hidden')
})
</script>

マルチターゲットの Collapse

data-bs-target は CSS セレクタを受け付けるため、1 つのトリガーで複数の要素をトグルできます — 共通クラス(.multi-collapse)を使って全てをターゲットにしましょう。逆に、複数のトリガーが同じターゲットを制御することもできます(それぞれが data-bs-target='#shared')。複数セクションをまとめて開閉する「すべて表示」/「すべて隠す」ボタンや、異なる場所のボタンが同じパネルを制御するレスポンシブレイアウトに有用です。セレクタ方式は非常に柔軟です。

bootstrap
<!-- one trigger toggles multiple targets -->
<p>
  <button class="btn btn-primary" data-bs-toggle="collapse"
          data-bs-target=".multi-collapse" aria-expanded="false">
    Toggle both
  </button>
</p>

<div class="row">
  <div class="col">
    <div class="collapse multi-collapse" id="first">
      <div class="card card-body">First block</div>
    </div>
  </div>
  <div class="col">
    <div class="collapse multi-collapse" id="second">
      <div class="card card-body">Second block</div>
    </div>
  </div>
</div>

<!-- multiple triggers control one target -->
<button class="btn btn-primary" data-bs-toggle="collapse"
        data-bs-target="#shared">Show A</button>
<button class="btn btn-secondary" data-bs-toggle="collapse"
        data-bs-target="#shared">Show B</button>
<div class="collapse" id="shared">
  <div class="card card-body">Shared content</div>
</div>
19

アイコンとアクセシビリティ

Bootstrap Icons

Bootstrap Icons は別のアイコンライブラリです(CSS には含まれない)。CSS を読み込み、<i class='bi bi-{name}'></i> を使います。アイコンのサイズは fs-*(font-size)ユーティリティで、色は text-* クラスで。ボタン内のアイコンは視覚的な手がかりで UX を向上させます。アイコンのみのボタンには MUST で aria-label を付けてください — なければボタンにアクセシブルな名前がありません。アイコンの閲覧は icons.getbootstrap.com。アイコンは SVG フォントなので、どのサイズでもくっきり拡大します。

bootstrap
<!-- Bootstrap Icons (separate from CSS framework) -->
<link rel="stylesheet"
      href="https://cdn.jsdelivr.net/npm/[email protected]/font/bootstrap-icons.css">

<!-- usage: <i class="bi bi-{name}"></i> -->
<i class="bi bi-alarm"></i>
<i class="bi bi-arrow-right"></i>
<i class="bi bi-check-circle"></i>
<i class="bi bi-github"></i>

<!-- sizing with utility classes -->
<i class="bi bi-star fs-1"></i>  <!-- font-size 1 -->
<i class="bi bi-star fs-3"></i>
<i class="bi bi-star fs-6"></i>

<!-- colored icons -->
<i class="bi bi-exclamation-triangle text-warning fs-3"></i>
<i class="bi bi-check-circle text-success fs-3"></i>

<!-- icon in a button -->
<button class="btn btn-primary">
  <i class="bi bi-download"></i> Download
</button>

<!-- icon-only button (needs aria-label) -->
<button class="btn btn-link" aria-label="Search">
  <i class="bi bi-search"></i>
</button>

アクセシビリティ:ARIA とロール

Bootstrap のコンポーネントには ARIA 属性が含まれますが、カスタムコントロールには自分で追加する必要があります。aria-label はアイコンのみのボタンに名前を与えます。aria-labelledby は他の要素の id をラベルとして参照します。aria-describedby はヘルプテキストを指し、aria-expanded はトグル状態(true/false)を反映します。aria-current='page' は現在のナビ項目を示します。暗黙の ARIA ロールを持つセマンティック HTML(nav、main、aside、header、footer)を使いましょう — div に role 属性を足すより優れています。

bootstrap
<!-- landmark roles (use semantic HTML) -->
<nav role="navigation">...</nav>
<main role="main">...</main>
<aside role="complementary">...</aside>
<footer role="contentinfo">...</footer>

<!-- aria-label for unlabeled controls -->
<button aria-label="Close" class="btn-close"></button>
<button aria-label="Search" class="btn"><i class="bi bi-search"></i></button>

<!-- aria-labelledby (reference another element) -->
<div role="dialog" aria-labelledby="modalTitle">
  <h2 id="modalTitle">Modal Heading</h2>
</div>

<!-- aria-describedby (descriptive text) -->
<input aria-describedby="emailHelp" id="email">
<small id="emailHelp">We'll never share your email.</small>

<!-- aria-expanded for toggles -->
<button aria-expanded="false" data-bs-toggle="collapse">
  Toggle
</button>

<!-- aria-current for current page -->
<a aria-current="page" class="nav-link active">Home</a>

Visually Hidden とスクリーンリーダー

visually-hidden はコンテンツを視覚的に隠しつつスクリーンリーダーには残します — アイコンのみのボタンのラベルや補足の文脈に使いましょう。visually-hidden-focusable はキーボードフォーカスまで隠れます(Tab で移動すると現れる「本文へスキップ」リンクに最適)。aria-hidden='true' は逆です:見えるが読み上げられない(装飾要素用)。キーボードアクセシビリティのため、最初のフォーカス可能な要素として必ずスキップリンクを提供しましょう。これらは WCAG 準拠に不可欠です。

bootstrap
<!-- visually hidden (hidden visually, read by screen readers) -->
<span class="visually-hidden">This text is read by screen readers</span>

<!-- for icon-only buttons -->
<button class="btn btn-primary" aria-label="Search">
  <i class="bi bi-search"></i>
  <span class="visually-hidden">Search</span>
</button>

<!-- skip link (keyboard users skip to content) -->
<a href="#main-content" class="visually-hidden-focusable">
  Skip to main content
</a>

<!-- visually-hidden-focusable: hidden until focused -->
<!-- useful for skip links that appear on Tab -->

<!-- main content target -->
<main id="main-content">
  <!-- skip link jumps here -->
</main>

<!-- hide from screen readers only (still visible) -->
<div aria-hidden="true">
  Decorative content (not announced)
</div>

モーション低減とダークモード

ダークモード:<html> に data-bs-theme='dark' を設定します — Bootstrap が CSS 変数を切り替えます。JS で属性を変えてトグルしましょう。システム設定は matchMedia('(prefers-color-scheme: dark)') で尊重できます。モーション低減については、ユーザーが prefers-reduced-motion: reduce を設定していれば Bootstrap がほとんどのアニメーションを自動的に無効化します。さらに減らすルールを追加することもできます。ユーザーのテーマ設定は localStorage に保存しましょう。これらの機能によりサイトはすべてのユーザーにとってアクセシブルで快適になります。

bootstrap
<!-- dark mode via data attribute -->
<html data-bs-theme="dark">
  <!-- entire page in dark mode -->
</html>

<!-- toggle dark mode via JS -->
<button id="themeToggle">Toggle theme</button>
<script>
const html = document.documentElement
const current = html.getAttribute('data-bs-theme')
html.setAttribute('data-bs-theme', current === 'dark' ? 'light' : 'dark')
</script>

<!-- respect system preference -->
<script>
if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
  document.documentElement.setAttribute('data-bs-theme', 'dark')
}
</script>

<!-- reduced motion: Bootstrap respects this automatically -->
@media (prefers-reduced-motion: reduce) {
  /* Bootstrap disables transitions and animations */
  /* but you can add more */
  .carousel {
    transition: none;
  }
}

フォーカス管理とキーボード

代替を提供せずにフォーカスの輪郭(outline: none)を取り除いてはいけません — キーボードユーザーに必要です。Bootstrap の focus-visible はマウスではなくキーボードフォーカスにのみリングを表示します。モーダルでは、表示時にフォーカスをモーダル内へ移し、非表示時にトリガーへ戻しましょう。カスタムウィジェット(タブ、メニュー)には矢印キーのナビゲーションが必要です — Arrow キー、Enter、Space、Escape の keydown ハンドラを実装します。適切な tabindex 管理(フォーカス可能は 0、プログラム的にフォーカス可能は -1)により論理的なタブ順を確保します。キーボードのみのユーザーに不可欠です。

bootstrap
<!-- visible focus (don't remove outlines!) -->
<!-- Bootstrap provides focus-visible styling -->
<button class="btn btn-primary">Has visible focus ring</button>

<!-- skip link (first focusable element) -->
<body>
  <a href="#main" class="visually-hidden-focusable">Skip to content</a>
  <nav>...</nav>
  <main id="main">...</main>
</body>

<!-- focus management for modals -->
<script>
const modal = document.getElementById('myModal')
modal.addEventListener('shown.bs.modal', () => {
  // focus first input in modal
  modal.querySelector('input')?.focus()
})
modal.addEventListener('hidden.bs.modal', () => {
  // return focus to trigger
  document.getElementById('openModalBtn').focus()
})
</script>

<!-- keyboard navigation for custom widgets -->
<div role="tablist">
  <button role="tab" tabindex="0">Tab 1</button>
  <button role="tab" tabindex="-1">Tab 2</button>
</div>
<script>
// arrow key navigation
document.querySelectorAll('[role="tab"]').forEach((tab, i, tabs) => {
  tab.addEventListener('keydown', (e) => {
    if (e.key === 'ArrowRight') tabs[(i + 1) % tabs.length].focus()
    if (e.key === 'ArrowLeft') tabs[(i - 1 + tabs.length) % tabs.length].focus()
  })
})
</script>
20

リストグループ

基本のリストグループ

list-group は一連のコンテンツを表示する柔軟なコンポーネントです。list-group-item が各項目を整形します。active が現在の項目を示し、disabled は灰色にします(アクセシビリティのため aria-disabled='true' も)。リストグループは、ダッシュボード、設定、受信箱の項目のような関連コンテンツのリストとして、スタイル付きの div よりセマンティックです。ナビゲーションリストには <ul>/<li>、リスト以外のコンテンツには <div> を使いましょう。

bootstrap
<!-- basic list group -->
<ul class="list-group">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">A disabled item</li>
</ul>

<!-- with active item -->
<ul class="list-group">
  <li class="list-group-item active" aria-current="true">Active item</li>
  <li class="list-group-item">Regular item</li>
</ul>

<!-- disabled item -->
<ul class="list-group">
  <li class="list-group-item disabled" aria-disabled="true">Disabled</li>
</ul>

リンクとボタン付きリストグループ

操作可能なリスト項目(クリック可能)には、<a> や <button> 要素に list-group-item-action を付けます。ホバーとフォーカス状態が加わります。ナビゲーションには <a>(href 付き)、操作には <button type='button'> を使いましょう。リンクの無効化には .disabled クラス(と aria-disabled)、ボタンの無効化には disabled 属性です。操作可能な項目に <li> を使うのは避けましょう — <a>/<button> は <ul> 内ではセマンティクスが弱いため、list-group のラッパーには <div> を使います。

bootstrap
<!-- list group with links (actionable items) -->
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active"
     aria-current="true">
    Active link item
  </a>
  <a href="#" class="list-group-item list-group-item-action">Link item</a>
  <a href="#" class="list-group-item list-group-item-action">Another link</a>
  <a class="list-group-item list-group-item-action disabled">Disabled link</a>
</div>

<!-- with buttons instead of links -->
<div class="list-group">
  <button type="button" class="list-group-item list-group-item-action active">
    Button item
  </button>
  <button type="button" class="list-group-item list-group-item-action">
    Another button
  </button>
</div>

<!-- note: use list-group-item-action for hover/focus states -->

リストグループの Flush と番号付き

list-group-flush は罫線と角丸を取り除きます — カードやコンテナへの埋め込み時に二重罫線を避けられます。list-group-numbered(<ol> 上)は CSS カウンタで自動番号を付けます。list-group-horizontal は項目を横に並べ、レスポンシブ版(list-group-horizontal-md)はブレークポイントで横並びに切り替わります。横並びのリストは小さなナビゲーションやフィルターバーに有用です。番号付きリストは手順やランキングに最適です。

bootstrap
<!-- flush (no borders, no background, edge-to-edge) -->
<ul class="list-group list-group-flush">
  <li class="list-group-item">Flush item 1</li>
  <li class="list-group-item">Flush item 2</li>
  <li class="list-group-item">Flush item 3</li>
</ul>
<!-- removes outer borders and rounded corners -->

<!-- numbered list group (ordered) -->
<ol class="list-group list-group-numbered">
  <li class="list-group-item">First item</li>
  <li class="list-group-item">Second item</li>
  <li class="list-group-item">Third item</li>
</ol>
<!-- CSS counters add the numbers automatically -->

<!-- horizontal list group -->
<ul class="list-group list-group-horizontal">
  <li class="list-group-item">Item 1</li>
  <li class="list-group-item">Item 2</li>
  <li class="list-group-item">Item 3</li>
</ul>

<!-- responsive horizontal -->
<ul class="list-group list-group-horizontal-md">
  <!-- horizontal at md+, vertical below -->
</ul>

リストグループの文脈色とバッジ

文脈クラス(list-group-item-{color})は状態表示のために項目に色を付けます — 意味を持って使いましょう(success = 完了、danger = エラー)。リスト項目内のバッジには、d-flex justify-content-between align-items-center でバッジを右へ押し垂直中央にそろえます。rounded-pill のバッジはカウント表示にモダンです。このパターンは定番の受信箱/通知リストです:左にラベル、右に数。flex ユーティリティでカスタム CSS なしに整列できます。

bootstrap
<!-- contextual color items -->
<ul class="list-group">
  <li class="list-group-item list-group-item-primary">Primary item</li>
  <li class="list-group-item list-group-item-secondary">Secondary</li>
  <li class="list-group-item list-group-item-success">Success</li>
  <li class="list-group-item list-group-item-danger">Danger</li>
  <li class="list-group-item list-group-item-warning">Warning</li>
  <li class="list-group-item list-group-item-info">Info</li>
  <li class="list-group-item list-group-item-light">Light</li>
  <li class="list-group-item list-group-item-dark">Dark</li>
</ul>

<!-- with badges (counts aligned right) -->
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Messages
    <span class="badge bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Notifications
    <span class="badge bg-danger rounded-pill">3</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    Spam
    <span class="badge bg-warning text-dark rounded-pill">1</span>
  </li>
</ul>

リストグループのカスタムコンテンツ

リスト項目にはリッチなコンテンツが入ります:見出し(fw-bold)、説明(text-muted)、メタデータ(small)、バッジ。コンテンツとバッジのレイアウトには d-flex justify-content-between align-items-start を使いましょう。me-auto でバッジを右へ押します。リスト項目内の checkbox/radio には、対応する form-check-label と form-check-input を使います — 選択可能なリストを作れます。よくある用途:タイトル、説明、状態を持つ項目のあるメールリスト、設定パネル、検索結果。

bootstrap
<!-- rich content list item -->
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Subheading</div>
      <p class="mb-0 text-muted">Descriptive text for the list item.</p>
      <small>Additional metadata</small>
    </div>
    <span class="badge bg-primary rounded-pill">New</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Another item</div>
      <p class="mb-0">More content here.</p>
    </div>
    <span class="badge bg-secondary rounded-pill">3</span>
  </li>
</ul>

<!-- list group with checkbox/radio -->
<ul class="list-group">
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" id="check1">
    <label class="form-check-label" for="check1">Checkbox item</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="radio" name="radio" id="radio1">
    <label class="form-check-label" for="radio1">Radio item</label>
  </li>
</ul>

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.