Плагин Tailwind CSS · v1.4.2

Сетка Bootstrap для Tailwind.

Если вы уже мыслите строками и колонками, продолжайте в том же духе. tw-bootstrap-grid приносит в Tailwind привычную 12-колоночную сетку с классами .row, .col-6, .offset-2 и .g-4, поддерживает RTL и ничего не диктует о том, как должны выглядеть ваши компоненты.

$npm install tw-bootstrap-grid

Что вы получаете

  • 12-колоночная сетка

    .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 v4

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

В конфигурации v3 на CommonJS также работает plugins: [require("tw-bootstrap-grid")].

3Используйте классы

Вот и всё. Применяйте их в разметке как любые другие классы Tailwind. Всё, что можно делать с sm:, md: или hover:, работает и здесь.

index.html
<div class="container">
  <div class="row g-4">
    <div class="col-12 md:col-6 lg:col-4">One</div>
    <div class="col-12 md:col-6 lg:col-4">Two</div>
    <div class="col-12 lg:col-4">Three</div>
  </div>
</div>

Нужен этап сборки

Плагин работает внутри компилятора Tailwind (PostCSS, Vite, Webpack, CLI Tailwind…). Он не работает со скриптом Tailwind Play CDN, который не умеет загружать плагины из npm.

Начало работы

Настройка

Значения по умолчанию совпадают с Bootstrap, так что эту страницу можно пропустить. Возвращайтесь, когда понадобятся другие брейкпоинты или размеры gutter.

Брейкпоинты

У плагина нет собственных брейкпоинтов. Префиксы вроде md:col-6 и максимальная ширина .container берутся из Tailwind, поэтому изменение ваших экранов меняет и сетку.

Tailwind v4

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

@theme {
  --breakpoint-sm: 40rem;  /* 640px */
  --breakpoint-md: 48rem;  /* 768px */
  --breakpoint-lg: 64rem;  /* 1024px */
  --breakpoint-xl: 80rem;  /* 1280px */
  --breakpoint-2xl: 96rem; /* 1536px */
}

Размеры gutter

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-xrowGutters / containerGuttersПобеждает самое конкретное значение.
2--bs-global-gutter-xguttersОбщее резервное значение для обоих.
31.5rem (x) и 0 (y)встроенное значение по умолчаниюТе же значения по умолчанию, что и в Bootstrap.

CSS-переменные читаются во время работы, поэтому в обеих версиях их можно переопределить на любом элементе, чтобы изменить gutter только в этом разделе. Для одной строки используйте .g-*, .gx-* и .gy-*.

Отключение контейнеров

Хотите использовать только собственный container Tailwind? Задайте generateContainers значение false, и плагин перестанет генерировать .container-fluid и внутренний отступ с учётом gutter. Строки и колонки это не затронет.

Tailwind v4

main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid" {
  generateContainers: false;
}

Почему в v4 переменные?

Tailwind v4 может передавать плагину простые значения вроде generateContainers: false;, но не вложенные объекты вроде gutters. CSS-переменные решают эту задачу и к тому же переопределяются для каждого элемента.

Справочник

Классы

Всё, что добавляет плагин, в одном месте.

Раскладка

Классы: Раскладка
КлассЧто делаетПримечания
.containerwidth: 100%; по центру; отступ из gutterМаксимальная ширина берётся из брейкпоинтов Tailwind.
.container-fluidто же, что .containerПолная ширина на каждом брейкпоинте.
.rowdisplay: flex; flex-wrap: wrap; отрицательные marginГасит внешний gutter и раскладывает потомков.

Колонки

Классы: Колонки
КлассЧто делаетПримечания
.colflex: 1 0 0%Делит оставшееся место поровну.
.col-autoflex: 0 0 auto; width: autoРазмер определяется содержимым.
.col-1 … .col-12flex: 0 0 auto; width: n / 12Занимает n из 12 долей.

Offset и колонки в строке

Классы: Offset и колонки в строке
КлассЧто делаетПримечания
.offset-0 … .offset-12margin-inline-start: n / 12В RTL автоматически зеркалится.
.row-cols-1 … .row-cols-6потомки получают width: 1 / nЗадаётся на .row и действует на каждого потомка.
.row-cols-autoпотомки получают width: autoРазмер потомков определяется содержимым.

Gutter

Классы: Gutter
КлассЧто делаетПримечания
.g-*--bs-gutter-x и --bs-gutter-yОба направления.
.gx-*--bs-gutter-xТолько по горизонтали.
.gy-*--bs-gutter-yТолько по вертикали.

Всё адаптивно

Добавьте префикс брейкпоинта к любому из классов выше: 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. В руководстве по миграции есть полное соответствие и команда, которая преобразует вашу разметку.

Нашли ошибку или есть идея?

Создайте issue (откроется в новой вкладке) или отправьте pull request (откроется в новой вкладке) на GitHub. Небольшие исправления и улучшения документации очень приветствуются.