Руководство
Миграция сетки Bootstrap на Tailwind CSS
Перенос раскладки с сетки Bootstrap на Tailwind занимает пять шагов, и большую часть работы делает одна команда. В руководстве описано, что меняется, как классы соответствуют друг другу и несколько вещей, которые скрипт за вас не сделает.
Миграция за пять шагов
Установите плагин
Установите tw-bootstrap-grid и подключите его в настройках Tailwind. В руководстве по установке есть фрагменты для Tailwind v3 и v4.
Повторите брейкпоинты Bootstrap (необязательно)
Если нужно, чтобы раскладки менялись на тех же ширинах, что раньше, задайте экраны Tailwind как 576, 768, 992, 1200 и 1400px. См. брейкпоинты ниже.
Переименуйте классы
Закоммитьте свою работу и запустите команду Perl ниже. Она заново нумерует gutter и превращает
col-md-6из Bootstrap вmd:col-6.Исправьте то, с чем команда не справится
Замените утилиты отступов вроде
mb-3наmb-4, поменяйте утилиты display и flex из Bootstrap на утилиты Tailwind и замените классы вродеcontainer-md.Уберите CSS Bootstrap и проверьте результат
Удалите таблицу стилей Bootstrap, затем просмотрите свои страницы при ширинах телефона, планшета и компьютера.
Что меняется, а что нет
Что остаётся прежним
Структура:
.container,.row,.col-*,.offset-*,.row-cols-*. Даже CSS-переменные сохраняют названия,--bs-gutter-xи--bs-gutter-y, поэтому ваш CSS, который их читает, продолжит работать.Префикс, а не инфикс
Bootstrap пишет
col-md-6. Tailwind пишетmd:col-6. Именно это вы будете менять чаще всего, и скрипт может сделать это за вас.Другие числа
Числа gutter и отступов следуют шкале Tailwind, поэтому
g-3из Bootstrap здесь —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 | Число тоже меняется, см. размеры gutter ниже. |
col-xxl-4 | 2xl:col-4 | xxl из Bootstrap в Tailwind называется 2xl. |
order-md-2 | md:order-2 | order-* принадлежит Tailwind и доходит до 12. |
Размеры gutter
| 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 | Утилиты отступов сдвигаются так же, как gutter. |
Повторите брейкпоинты 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 */
}container в Tailwind имеет ширину того брейкпоинта, на котором находится, поэтому его максимальная ширина становится 576, 768, 992, 1200 и 1400px. Это близко к 540, 720, 960, 1140 и 1320px из Bootstrap, но не совпадает с ними.
Массовое переименование
Эта команда Perl заново нумерует gutter и превращает col-md-6 в md:col-6, col-xxl-4 в 2xl:col-4, а старый no-gutters в g-0. Она переписывает файлы на месте, поэтому сначала сделайте коммит, а потом прочитайте diff.
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')Запустите один раз и проверьте результат
mb-3 или p-3 нужно поправить вручную, а шаблон срабатывает на любой текст, похожий на класс, в том числе в комментариях.Что не переносится
.container и .container-fluid, поэтому .container-sm, .container-md и другие адаптивные контейнеры Bootstrap не включены. При необходимости соберите их из утилит max-w-* Tailwind. Остальные утилиты Bootstrap (display, flex, отступы, текст) заменяются утилитами Tailwind, как в последней таблице выше.