Руководство

Миграция сетки Bootstrap на Tailwind CSS

Перенос раскладки с сетки Bootstrap на Tailwind занимает пять шагов, и большую часть работы делает одна команда. В руководстве описано, что меняется, как классы соответствуют друг другу и несколько вещей, которые скрипт за вас не сделает.

Миграция за пять шагов

  1. Установите плагин

    Установите tw-bootstrap-grid и подключите его в настройках Tailwind. В руководстве по установке есть фрагменты для Tailwind v3 и v4.

  2. Повторите брейкпоинты Bootstrap (необязательно)

    Если нужно, чтобы раскладки менялись на тех же ширинах, что раньше, задайте экраны Tailwind как 576, 768, 992, 1200 и 1400px. См. брейкпоинты ниже.

  3. Переименуйте классы

    Закоммитьте свою работу и запустите команду Perl ниже. Она заново нумерует gutter и превращает col-md-6 из Bootstrap в md:col-6.

  4. Исправьте то, с чем команда не справится

    Замените утилиты отступов вроде mb-3 на mb-4, поменяйте утилиты display и flex из Bootstrap на утилиты Tailwind и замените классы вроде container-md.

  5. Уберите 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

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Число тоже меняется, см. размеры gutter ниже.
col-xxl-42xl:col-4xxl из Bootstrap в Tailwind называется 2xl.
order-md-2md:order-2order-* принадлежит Tailwind и доходит до 12.

Размеры gutter

Размеры gutter
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Утилиты отступов сдвигаются так же, как gutter.

Повторите брейкпоинты 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 */
}

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.

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')

Запустите один раз и проверьте результат

Повторный запуск заново пронумерует gutter. Кроме того, она знает только перечисленные выше классы, поэтому утилиты отступов вроде mb-3 или p-3 нужно поправить вручную, а шаблон срабатывает на любой текст, похожий на класс, в том числе в комментариях.

Что не переносится

Плагин добавляет только .container и .container-fluid, поэтому .container-sm, .container-md и другие адаптивные контейнеры Bootstrap не включены. При необходимости соберите их из утилит max-w-* Tailwind. Остальные утилиты Bootstrap (display, flex, отступы, текст) заменяются утилитами Tailwind, как в последней таблице выше.

Что дальше