ガイド

Bootstrap グリッドから Tailwind CSS への移行

レイアウトを Bootstrap のグリッドから Tailwind へ移すのは 5 つのステップで済み、その大半はコマンド 1 つでできます。このガイドでは、何が変わるのか、クラスがどう対応するのか、そしてスクリプトでは代わりにできない数点を説明します。

5 つのステップで移行する

  1. プラグインをインストールする

    tw-bootstrap-grid をインストールし、Tailwind の設定に登録します。インストールガイドに Tailwind v3 と v4 のコードがあります。

  2. Bootstrap のブレークポイントに合わせる(任意)

    レイアウトを以前と同じ幅で切り替えたい場合は、Tailwind のスクリーンを 576、768、992、1200、1400px に設定します。下のブレークポイントを参照してください。

  3. クラスの名前を変える

    作業をコミットしてから、下の Perl コマンドを実行します。ガターの数値を付け替え、Bootstrap の col-md-6 を md:col-6 に変えます。

  4. コマンドで直せない部分を直す

    mb-3 のようなスペーシングのユーティリティを mb-4 に変え、Bootstrap の display や flex のユーティリティを Tailwind のものに置き換え、container-md のようなクラスを置き換えます。

  5. Bootstrap の CSS を外して結果を確認する

    Bootstrap のスタイルシートを外し、スマートフォン、タブレット、デスクトップの幅でページを見て回ります。

変わるものと変わらないもの

  • 変わらないもの

    構造です。.container、.row、.col-*、.offset-*、.row-cols-*。CSS 変数の名前も --bs-gutter-x と --bs-gutter-y のままなので、それらを読む独自の CSS もそのまま動きます。

  • 中置ではなく接頭辞

    Bootstrap では col-md-6 と書きます。Tailwind では md:col-6 と書きます。いちばん多く手を入れる部分ですが、スクリプトで置き換えられます。

  • 異なる数値

    ガターとスペーシングの数値は Tailwind のスケールに従うので、Bootstrap の g-3 はここでは g-4 です。ブレークポイントの幅も少し違います。

同じレイアウトの移行前と移行後

Bootstrap 5

index.html
<div class="container">
  <div class="row g-3">
    <div class="col-12 col-md-6 col-lg-4">A</div>
    <div class="col-12 col-md-6 col-lg-4">B</div>
    <div class="col-12 col-md-12 col-lg-4">C</div>
  </div>
</div>

tw-bootstrap-grid

index.html
<div class="container">
  <div class="row g-4">
    <div class="col-12 md:col-6 lg:col-4">A</div>
    <div class="col-12 md:col-6 lg:col-4">B</div>
    <div class="col-12 md:col-12 lg:col-4">C</div>
  </div>
</div>

クラスの対応

レスポンシブなクラス

レスポンシブなクラス
Bootstrapここでは備考
col-md-6md:col-6Tailwind ではブレークポイントを先頭に、接頭辞として付けます。
col-lglg:col等幅のカラムも同じです。
col-xl-autoxl:col-auto
offset-md-3md:offset-3
row-cols-md-3md:row-cols-3
g-md-4md:g-6数値も変わります。下のガターのサイズを参照してください。
col-xxl-42xl:col-4Bootstrap の xxl は Tailwind では 2xl と呼びます。
order-md-2md:order-2order-* は Tailwind 自身のもので、12 まであります。

ガターのサイズ

ガターのサイズ
Bootstrapここではサイズ
g-0g-00
g-1g-10.25rem
g-2g-20.5rem
g-3g-41rem
g-4g-61.5rem
g-5g-123rem

Tailwind から来るユーティリティ

Tailwind から来るユーティリティ
Bootstrapここでは備考
d-flexflex
d-none d-md-blockhidden md:block
justify-content-betweenjustify-between
align-items-centeritems-center
align-self-endself-end
mb-3, p-3mb-4, p-4スペーシングのユーティリティもガターと同じようにずれます。

Bootstrap のブレークポイントに合わせる

Bootstrap のブレークポイントは 576、768、992、1200、1400px です。Tailwind は 640、768、1024、1280、1536px なので、移行後にレイアウトが少し早く、または遅く切り替わることがあります。それが気になる場合は、Tailwind のスクリーンを Bootstrap の値に設定してください。

Tailwind v4

main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";

@theme {
  --breakpoint-sm: 36rem;    /* 576px */
  --breakpoint-md: 48rem;    /* 768px */
  --breakpoint-lg: 62rem;    /* 992px */
  --breakpoint-xl: 75rem;    /* 1200px */
  --breakpoint-2xl: 87.5rem; /* 1400px */
}

Tailwind の container は、置かれたブレークポイントと同じ幅になるので、最大幅は 576、768、992、1200、1400px になります。Bootstrap の 540、720、960、1140、1320px に近い値ですが、同じではありません。

まとめて名前を変える

この Perl コマンドは、ガターの数値を付け替え、col-md-6 を md:col-6 に、col-xxl-4 を 2xl:col-4 に、古い no-gutters を g-0 に変えます。ファイルをその場で書き換えるので、先にコミットしておき、実行後に差分を確認してください。

terminal
perl -pi -e '
  s/\b(g|gx|gy)-((?:sm|md|lg|xl|xxl)-)?([345])\b/"$1-".($2\/\/"").{3=>4,4=>6,5=>12}->{$3}/ge;
  s/\bno-gutters\b/g-0/g;
  s/\b(col|offset|order|row-cols|g|gx|gy)-(sm|md|lg|xl|xxl)(-([0-9]+|auto|first|last))?\b/$2:$1$3/g;
  s/\bxxl:/2xl:/g;
' $(git ls-files '*.html' '*.jsx' '*.tsx' '*.vue' '*.svelte')

1 回だけ実行し、結果を確認してください

2 回目を実行すると、ガターの数値がもう一度付け替えられてしまいます。また、上のクラス名しか知らないため、mb-3 や p-3 のようなスペーシングのユーティリティは手作業で直す必要があり、パターンはコメントの中を含め、クラスのように見えるあらゆる文字列に一致します。

引き継がれないもの

プラグインが追加するのは .container と .container-fluid だけなので、Bootstrap の .container-sm、.container-md などのレスポンシブなコンテナは含まれません。必要なら Tailwind の max-w-* ユーティリティで作ってください。Bootstrap のそのほかのユーティリティ(display、flex、スペーシング、テキスト)は、上の最後の表のように Tailwind のものに置き換わります。

次に読む