Если вы уже мыслите строками и колонками, продолжайте в том же духе. tw-bootstrap-grid приносит в Tailwind привычную 12-колоночную сетку с классами .row, .col-6, .offset-2 и .g-4, поддерживает RTL и ничего не диктует о том, как должны выглядеть ваши компоненты.
.row, .col, .col-auto и классы от .col-1 до .col-12, как в Bootstrap.
Gutter из вашей темы
.g-*, .gx-* и .gy-* используют шкалу отступов Tailwind, поэтому согласуются с остальным вашим дизайном.
Offset
Классы от .offset-0 до .offset-12, чтобы центрировать колонку или оставить пустое место.
Колонки в строке
Классы от .row-cols-1 до .row-cols-6 и .row-cols-auto задают размер всех потомков одним классом на строке.
Контейнеры
.container и .container-fluid с внутренним отступом, учитывающим gutter. Максимальная ширина берётся из брейкпоинтов самого Tailwind.
Адаптивность и RTL
Каждый класс принимает префиксы брейкпоинтов Tailwind, например md:col-6, и правильно зеркалится при dir="rtl".
Он отвечает только за раскладку: никаких цветов, компонентов и сбросов стилей. Он дополняет Tailwind и ничего не заменяет, так что col-4 и flex можно без колебаний использовать на одной странице.
Начало работы
Установка
Три шага: установить пакет, подключить плагин и начать пользоваться классами.
1Установите пакет
npm install tw-bootstrap-grid
2Подключите плагин
Выберите версию Tailwind в шапке, и фрагмент ниже подстроится. Tailwind v4 подключает плагины в CSS, v3 — в файле конфигурации.
Плагин работает внутри компилятора Tailwind (PostCSS, Vite, Webpack, CLI Tailwind…). Он не работает со скриптом Tailwind Play CDN, который не умеет загружать плагины из npm.
Начало работы
Настройка
Значения по умолчанию совпадают с Bootstrap, так что эту страницу можно пропустить. Возвращайтесь, когда понадобятся другие брейкпоинты или размеры gutter.
Брейкпоинты
У плагина нет собственных брейкпоинтов. Префиксы вроде md:col-6 и максимальная ширина .container берутся из Tailwind, поэтому изменение ваших экранов меняет и сетку.
Gutter — это промежуток между колонками. По умолчанию он равен 1.5rem по горизонтали и 0 по вертикали. Его можно задать один раз для всего или отдельно для контейнеров и строк. В v3 вы передаёте плагину параметры, в v4 задаёте CSS-переменные.
Tailwind v4
main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";
:root {
/* used by containers and rows */
--bs-global-gutter-x: 1.5rem;
--bs-global-gutter-y: 0;
/* overrides for one of them only */
--bs-container-gutter-x: 1rem;
--bs-row-gutter-x: 2rem;
--bs-row-gutter-y: 1rem;
}
Порядок определения gutter
Приоритет
CSS-переменная
Параметр
Примечания
1
--bs-row-gutter-x / --bs-container-gutter-x
rowGutters / containerGutters
Побеждает самое конкретное значение.
2
--bs-global-gutter-x
gutters
Общее резервное значение для обоих.
3
1.5rem (x) и 0 (y)
встроенное значение по умолчанию
Те же значения по умолчанию, что и в Bootstrap.
CSS-переменные читаются во время работы, поэтому в обеих версиях их можно переопределить на любом элементе, чтобы изменить gutter только в этом разделе. Для одной строки используйте .g-*, .gx-* и .gy-*.
Отключение контейнеров
Хотите использовать только собственный container Tailwind? Задайте generateContainers значение false, и плагин перестанет генерировать .container-fluid и внутренний отступ с учётом gutter. Строки и колонки это не затронет.
Tailwind v4 может передавать плагину простые значения вроде generateContainers: false;, но не вложенные объекты вроде gutters. CSS-переменные решают эту задачу и к тому же переопределяются для каждого элемента.
Справочник
Классы
Всё, что добавляет плагин, в одном месте.
Раскладка
Классы: Раскладка
Класс
Что делает
Примечания
.container
width: 100%; по центру; отступ из gutter
Максимальная ширина берётся из брейкпоинтов Tailwind.
Добавьте префикс брейкпоинта к любому из классов выше: md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.
Какие шаги gutter существуют?
.g-*, .gx-* и .gy-* строятся из вашей темы отступов. В v3 это каждый ключ theme.spacing без точки (то есть g-4 есть, g-0.5 нет). В v4 это стандартная шкала, от g-0 до g-96 и g-px.
Выравнивание и порядок берутся из Tailwind
Плагин не поставляет собственные justify-*, items-* и order-*. .row — обычный flex-контейнер, поэтому утилиты Tailwind работают на нём напрямую.
Если вы пришли из 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. Ширины брейкпоинтов тоже немного отличаются.
В полном руководстве есть таблицы соответствия классов, изменения размеров gutter, способ повторить брейкпоинты Bootstrap и команда, которая преобразует вашу разметку.
Каждый пример интерактивен. Редактируйте HTML слева, и предпросмотр обновляется по мере набора. Если вы знакомы с сеткой Bootstrap (откроется в новой вкладке), всё покажется знакомым.
Простая раскладка
.container центрирует содержимое, .row выстраивает колонки рядом, а каждая .col-* занимает столько из 12 доступных долей. Две колонки col-6 делят строку пополам.
Предпросмотр
Редактируемый HTML
Колонки всегда переносятся. Всё, что выходит за 12 долей в одной строке, переходит на следующую, что удобно для списков карточек.
Равные колонки и колонки с автоматической шириной
Простой .col делит оставшееся место, поэтому три таких класса дают три равные колонки. .col-auto подстраивается под содержимое, а соседний .col занимает остаток.
Предпросмотр
Редактируемый HTML
Адаптивные колонки
Каждый класс принимает префиксы брейкпоинтов Tailwind. Начните с мобильной версии через col-12, затем меняйте ширину на больших экранах с помощью sm:, md:, lg: и так далее. Кнопки ширины над предпросмотром покажут, как срабатывает каждый брейкпоинт.
Предпросмотр
768px · md · 0%
Редактируемый HTML
Предпросмотр — настоящий viewport. В углу он показывает ширину и брейкпоинт, а кнопки телефона, планшета и компьютера переключают его, поэтому md: и lg: применяются так же, как на таком экране.
Gutter
Gutter — это промежутки между колонками. .g-* задаёт оба направления, .gx-* только горизонтальное, .gy-* только вертикальное. Числа берутся из шкалы отступов Tailwind, так что g-4 — тот же шаг, что и p-4.
Предпросмотр
Редактируемый HTML
Ставьте классы gutter на .row. Чтобы полностью убрать промежутки, используйте g-0.
Offset
.offset-* сдвигает колонку на указанное число долей. Это быстрый способ отцентрировать колонку или оставить пустое место. Offset работает и с префиксами брейкпоинтов, например lg:offset-3.
Предпросмотр
Редактируемый HTML
Offset использует margin-inline-start, поэтому сдвигает с правильной стороны, когда страница идёт справа налево. Попробуйте кнопку RTL над предпросмотром.
Колонки в строке
Если все колонки одного размера, задайте это один раз на строке, а не на каждом потомке. .row-cols-1 — .row-cols-6 дают каждому потомку равную долю, а .row-cols-auto подстраивает их под содержимое.
Предпросмотр
Редактируемый HTML
Сочетайте с брейкпоинтами, чтобы менять число колонок по мере роста экрана, например row-cols-2 lg:row-cols-3.
Вложенность
Внутри колонки может быть своя .row. Вложенная строка начинает новую сетку из 12 долей внутри колонки, поэтому пространство можно делить сколько угодно раз.
Предпросмотр
Редактируемый HTML
Выравнивание и порядок
.row — обычный flex-контейнер, поэтому на нём работают утилиты flexbox Tailwind: items-*, justify-*, self-* и order-*. Плагин их не переопределяет.
Предпросмотр
Редактируемый HTML
Перестановки вроде order-2 md:order-1 — распространённый приём: на телефонах располагайте в одном порядке, на больших экранах меняйте на обратный.
Справа налево
Задайте dir="rtl" на контейнере или на <html> для всей страницы, и сетка будет идти справа. Это то, что нужно для арабского, персидского, иврита и других языков RTL.
Предпросмотр
Редактируемый HTML
Настраивать ничего не нужно. Gutter строки симметричны, а offset используют логические свойства, поэтому зеркалятся сами.
Полезно знать
Справа налево
Добавьте dir="rtl", и сетка отразится сама. Настраивать ничего не нужно.
Для всей страницы
index.html
<html dir="rtl">
...
</html>
Для одного раздела
index.html
<div class="container" dir="rtl">
<div class="row">
<div class="col-6 offset-3">Starts from the right</div>
</div>
</div>
Почему это просто работает
Offset используют margin-inline-start, а отрицательные margin строки и внутренние отступы колонок симметричны, поэтому всё зеркалится само. Чтобы увидеть это, нажмите кнопку RTL у любого примера выше.
Полезно знать
Частые вопросы
Ответы на самые частые вопросы.
Нет. container из Tailwind по-прежнему задаёт максимальную ширину для каждого брейкпоинта. Плагин добавляет поверх него центрирование и внутренний отступ с учётом gutter. Если это не нужно, задайте generateContainers значение false.
Да, в этом и идея. .row — flex-контейнер, поэтому items-center, justify-between, order-2, mt-4 и остальные действуют на него и на его колонки как обычно.
Tailwind генерирует CSS только для классов, которые находит в ваших исходных файлах. В вашем проекте это происходит автоматически. На этой странице редактируемые примеры могут содержать что угодно, поэтому демо заранее генерирует все классы плагина и все брейкпоинты.
Нет. Скрипт CDN не умеет загружать плагины из npm. Используйте сборку, например Vite, PostCSS, Webpack или CLI Tailwind.
Tailwind v3.4 и v4, на Node 18 и новее. Пакет содержит сборки ESM и CommonJS с типами TypeScript.
Названия классов близки: col-md-6 становится md:col-6, а числа gutter следуют шкале Tailwind. В руководстве по миграции есть полное соответствие и команда, которая преобразует вашу разметку.