ガイド
Bootstrap グリッドから Tailwind CSS への移行
レイアウトを Bootstrap のグリッドから Tailwind へ移すのは 5 つのステップで済み、その大半はコマンド 1 つでできます。このガイドでは、何が変わるのか、クラスがどう対応するのか、そしてスクリプトでは代わりにできない数点を説明します。
5 つのステップで移行する
プラグインをインストールする
tw-bootstrap-grid をインストールし、Tailwind の設定に登録します。インストールガイドに Tailwind v3 と v4 のコードがあります。
Bootstrap のブレークポイントに合わせる(任意)
レイアウトを以前と同じ幅で切り替えたい場合は、Tailwind のスクリーンを 576、768、992、1200、1400px に設定します。下のブレークポイントを参照してください。
クラスの名前を変える
作業をコミットしてから、下の Perl コマンドを実行します。ガターの数値を付け替え、Bootstrap の
col-md-6をmd:col-6に変えます。コマンドで直せない部分を直す
mb-3のようなスペーシングのユーティリティをmb-4に変え、Bootstrap の display や flex のユーティリティを Tailwind のものに置き換え、container-mdのようなクラスを置き換えます。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
<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
<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-6 | md:col-6 | Tailwind ではブレークポイントを先頭に、接頭辞として付けます。 |
col-lg | lg:col | 等幅のカラムも同じです。 |
col-xl-auto | xl:col-auto | |
offset-md-3 | md:offset-3 | |
row-cols-md-3 | md:row-cols-3 | |
g-md-4 | md:g-6 | 数値も変わります。下のガターのサイズを参照してください。 |
col-xxl-4 | 2xl:col-4 | Bootstrap の xxl は Tailwind では 2xl と呼びます。 |
order-md-2 | md:order-2 | order-* は Tailwind 自身のもので、12 まであります。 |
ガターのサイズ
| Bootstrap | ここでは | サイズ |
|---|---|---|
g-0 | g-0 | 0 |
g-1 | g-1 | 0.25rem |
g-2 | g-2 | 0.5rem |
g-3 | g-4 | 1rem |
g-4 | g-6 | 1.5rem |
g-5 | g-12 | 3rem |
Tailwind から来るユーティリティ
| Bootstrap | ここでは | 備考 |
|---|---|---|
d-flex | flex | |
d-none d-md-block | hidden md:block | |
justify-content-between | justify-between | |
align-items-center | items-center | |
align-self-end | self-end | |
mb-3, p-3 | mb-4, p-4 | スペーシングのユーティリティもガターと同じようにずれます。 |
Bootstrap のブレークポイントに合わせる
Bootstrap のブレークポイントは 576、768、992、1200、1400px です。Tailwind は 640、768、1024、1280、1536px なので、移行後にレイアウトが少し早く、または遅く切り替わることがあります。それが気になる場合は、Tailwind のスクリーンを Bootstrap の値に設定してください。
Tailwind v4
@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 に変えます。ファイルをその場で書き換えるので、先にコミットしておき、実行後に差分を確認してください。
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 回だけ実行し、結果を確認してください
mb-3 や p-3 のようなスペーシングのユーティリティは手作業で直す必要があり、パターンはコメントの中を含め、クラスのように見えるあらゆる文字列に一致します。引き継がれないもの
.container と .container-fluid だけなので、Bootstrap の .container-sm、.container-md などのレスポンシブなコンテナは含まれません。必要なら Tailwind の max-w-* ユーティリティで作ってください。Bootstrap のそのほかのユーティリティ(display、flex、スペーシング、テキスト)は、上の最後の表のように Tailwind のものに置き換わります。