Tailwind CSS eklentisi · v1.4.2

Bootstrap grid, Tailwind için.

Satır ve sütun düşünmeye alışkınsanız, devam edin. tw-bootstrap-grid tanıdık 12 sütunlu grid'i, yani .row, .col-6, .offset-2 ve .g-4 sınıflarını Tailwind'e getirir. RTL desteği vardır ve bileşenlerinizin nasıl görüneceği konusunda hiçbir fikri dayatmaz.

$npm install tw-bootstrap-grid

Neler sunuyor

  • 12 sütunlu grid

    .row, .col, .col-auto ve .col-1 ile .col-12 arası sınıflar, tıpkı Bootstrap'teki gibi.

  • Temanızdan gelen gutter'lar

    .g-*, .gx-* ve .gy-* Tailwind boşluk ölçeğinizi kullanır, böylece tasarımınızın geri kalanıyla uyumlu olur.

  • Offset'ler

    Bir sütunu ortalamak ya da boşluk bırakmak için .offset-0 ile .offset-12 arası sınıflar.

  • Row sütunları

    .row-cols-1 ile .row-cols-6 arası sınıflar ve .row-cols-auto, satırdaki tek bir sınıfla tüm çocukların genişliğini belirler.

  • Container'lar

    Gutter'a duyarlı iç boşluğa sahip .container ve .container-fluid. Maksimum genişlikler Tailwind'in kendi breakpoint'lerinden gelir.

  • Responsive ve RTL

    Her sınıf md:col-6 gibi Tailwind breakpoint önekleri alır ve dir="rtl" ile doğru şekilde yön değiştirir.

Yalnızca yerleşimle ilgilenir: renk, bileşen ya da sıfırlama yoktur. Tailwind'in yerine geçmez, ona ekleme yapar. Bu yüzden aynı sayfada col-4 ile flex kullanmak için iki kez düşünmenize gerek kalmaz.

Başlarken

Kurulum

Üç adım: paketi kurun, eklentiyi kaydedin, sınıfları kullanmaya başlayın.

1Paketi kurun

npm install tw-bootstrap-grid

2Eklentiyi kaydedin

Üst çubuktan Tailwind sürümünüzü seçin, aşağıdaki kod ona göre değişir. Tailwind v4 eklentileri CSS'te, v3 ise yapılandırma dosyasında kaydeder.

Tailwind v4

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

CommonJS kullanan bir v3 yapılandırmasında plugins: [require("tw-bootstrap-grid")] da çalışır.

3Sınıfları kullanın

Hepsi bu kadar. Sınıfları işaretlemenizde diğer Tailwind sınıfları gibi kullanın. sm:, md: veya hover: ile yapabildiğiniz her şey burada da çalışır.

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>

Bir derleme adımı gerekir

Eklenti Tailwind'in derleyicisinin içinde çalışır (PostCSS, Vite, Webpack, Tailwind CLI…). Eklentileri npm'den yükleyemeyen Tailwind Play CDN betiğiyle çalışamaz.

Başlarken

Yapılandırma

Varsayılanlar Bootstrap ile aynıdır, bu sayfayı atlayabilirsiniz. Farklı breakpoint'ler ya da gutter boyutları istediğinizde geri dönün.

Breakpoint'ler

Eklentinin kendi breakpoint'i yoktur. md:col-6 gibi önekler ve .container'ın maksimum genişliği ikisi de Tailwind'den gelir, bu yüzden ekranlarınızı değiştirmek grid'i de değiştirir.

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 boyutları

Gutter'lar sütunlar arasındaki boşluktur. Varsayılan olarak yatayda 1.5rem, dikeyde 0'dır. Hepsi için bir kez ayarlayabilir ya da container'lar ve satırlar için ayrı ayrı belirleyebilirsiniz. v3'te eklentiye seçenekler verirsiniz, v4'te CSS değişkenlerini ayarlarsınız.

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 çözümleme sırası
ÖncelikCSS değişkeniSeçenekNotlar
1--bs-row-gutter-x / --bs-container-gutter-xrowGutters / containerGuttersEn belirli değer kazanır.
2--bs-global-gutter-xguttersİkisi için ortak yedek değer.
31.5rem (x) ve 0 (y)yerleşik varsayılanBootstrap'in kullandığı varsayılanların aynısı.

CSS değişkenleri çalışma anında okunur. Bu yüzden iki sürümde de herhangi bir öğede ezerek yalnızca o bölümün gutter'larını değiştirebilirsiniz. Tek bir satır için .g-*, .gx-* ve .gy-* kullanın.

Container'ları kapatın

Yalnızca Tailwind'in kendi container'ını mı tercih ediyorsunuz? generateContainers değerini false yapın, eklenti .container-fluid ve gutter'a duyarlı iç boşluğu üretmeyi bırakır. Satırlar ve sütunlar etkilenmez.

Tailwind v4

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

v4'te neden değişkenler?

Tailwind v4 eklentiye generateContainers: false; gibi basit değerler verebilir, ama gutters gibi iç içe nesneler veremez. CSS değişkenleri bu durumu karşılar ve öğe başına ezilebilme avantajı da sunar.

Başvuru

Sınıflar

Eklentinin eklediği her şey, tek yerde.

Yerleşim

Yerleşim sınıfları
SınıfNe yaparNotlar
.containerwidth: 100%; ortalı; iç boşluk gutter'dan gelirMaksimum genişlik Tailwind'in breakpoint'lerinden gelir.
.container-fluid.container ile aynıHer breakpoint'te tam genişlik.
.rowdisplay: flex; flex-wrap: wrap; negatif marginDış gutter'ı iptal eder ve çocuklarını yerleştirir.

Sütunlar

Sütunlar sınıfları
SınıfNe yaparNotlar
.colflex: 1 0 0%Kalan alanı eşit paylaşır.
.col-autoflex: 0 0 auto; width: autoİçeriğine göre boyutlanır.
.col-1 … .col-12flex: 0 0 auto; width: n / 1212 dilimden n tanesini kaplar.

Offset'ler ve row sütunları

Offset'ler ve row sütunları sınıfları
SınıfNe yaparNotlar
.offset-0 … .offset-12margin-inline-start: n / 12RTL'de otomatik olarak yön değiştirir.
.row-cols-1 … .row-cols-6çocuklar width: 1 / n alır.row üzerinde ayarlanır, her çocuğa uygulanır.
.row-cols-autoçocuklar width: auto alırÇocuklar içeriğine göre boyutlanır.

Gutter'lar

Gutter'lar sınıfları
SınıfNe yaparNotlar
.g-*--bs-gutter-x ve --bs-gutter-yHer iki yön.
.gx-*--bs-gutter-xYalnızca yatay.
.gy-*--bs-gutter-yYalnızca dikey.

Her şey responsive

Yukarıdaki her sınıfa bir breakpoint öneki ekleyin: md:col-6, lg:offset-3, sm:row-cols-2, xl:g-8.

Hangi gutter adımları var?

.g-*, .gx-* ve .gy-* boşluk temanızdan üretilir. v3'te theme.spacing içindeki noktasız her anahtar kullanılır (yani g-4 var, g-0.5 yok). v4'te varsayılan ölçek, yani g-0 ile g-96 arası ve g-px.

Hizalama ve sıralama Tailwind'den gelir

Eklenti kendi justify-*, items-* ya da order-* sınıflarını sunmaz. .row sıradan bir flex container'dır, bu yüzden Tailwind'in yardımcı sınıfları ona doğrudan uygulanır.

Bootstrap'ten geliyorsanız

Bootstrap'ten geçiş

Grid hatırladığınız gibi çalışır. Üç şey farklı görünür: responsive sınıfların yazımı, boşluk sayıları ve breakpoint genişlikleri.

  • Değişmeyenler

    Yapı aynı: .container, .row, .col-*, .offset-*, .row-cols-*. CSS değişkenlerinin adları bile aynı kalır, --bs-gutter-x ve --bs-gutter-y. Bu yüzden onları okuyan özel CSS çalışmaya devam eder.

  • Ön ek, ara ek değil

    Bootstrap col-md-6 yazar. Tailwind md:col-6 yazar. En çok dokunacağınız değişiklik budur ve bir betik bunu sizin yerinize yapabilir.

  • Farklı sayılar

    Gutter ve boşluk sayıları Tailwind ölçeğini izler, yani Bootstrap'in g-3'ü burada g-4'tür. Breakpoint genişlikleri de biraz farklıdır.

Tam rehberde sınıf eşleme tabloları, gutter boyutlarındaki değişiklikler, Bootstrap'in breakpoint'lerini nasıl eşleyeceğiniz ve kodunuzu dönüştüren bir komut var.

Geçiş rehberini okuyun

Kullanım

Örnekler

Her örnek canlıdır. Soldaki HTML'i düzenleyin, önizleme siz yazdıkça güncellenir. Bootstrap grid (yeni sekmede açılır) sistemini biliyorsanız bu size tanıdık gelecek.

Temel bir yerleşim

.container içeriğinizi ortalar, .row sütunları yan yana dizer ve her .col-* 12 dilimden o kadarını kaplar. İki col-6 sütunu satırı ikiye böler.

Önizleme
Düzenlenebilir HTML

Sütunlar her zaman alt satıra geçer. Tek satırda 12 dilimi aşan her şey bir alt satıra iner, bu da kart listeleri için kullanışlıdır.

Eşit ve otomatik genişlikli sütunlar

Yalın bir .col kalan alanı paylaşır, yani üçü yan yana üç eşit sütun olur. .col-auto içeriğine göre boyutlanır, yanındaki .col da geri kalanı alır.

Önizleme
Düzenlenebilir HTML

Responsive sütunlar

Her sınıf Tailwind breakpoint öneklerini alır. Önce mobil için col-12 ile başlayın, sonra daha büyük ekranlarda sm:, md:, lg: ve benzerleriyle genişliği değiştirin. Her breakpoint'in devreye girişini görmek için önizlemenin üstündeki genişlik düğmelerini kullanın.

Önizleme
768px · md · 0%
Düzenlenebilir HTML

Önizleme gerçek bir viewport'tur. Köşede genişliği ve breakpoint'i gösterir, telefon, tablet ve masaüstü düğmeleri onu değiştirir. Böylece md: ve lg: o ekranda nasıl uygulanacaksa öyle uygulanır.

Gutter'lar

Gutter'lar sütunlar arasındaki boşluklardır. .g-* iki yönü, .gx-* yalnızca yatayı, .gy-* yalnızca dikeyi ayarlar. Sayılar Tailwind boşluk ölçeğinden gelir, yani g-4 ile p-4 aynı adımdır.

Önizleme
Düzenlenebilir HTML

Gutter sınıflarını .row üzerine koyun. Boşlukları tamamen kaldırmak için g-0 kullanın.

Offset'ler

.offset-* bir sütunu o kadar dilim kadar öteler. Bir sütunu ortalamanın ya da boşluk bırakmanın hızlı yoludur. Offset'ler lg:offset-3 gibi breakpoint öneklerini de kabul eder.

Önizleme
Düzenlenebilir HTML

Offset'ler margin-inline-start kullanır, bu yüzden sayfa sağdan sola olduğunda doğru taraftan iterler. Önizlemenin üstündeki RTL düğmesini deneyin.

Row sütunları

Tüm sütunlar aynı boyuttaysa bunu her çocuğa değil, satıra bir kez yazın. .row-cols-1 ile .row-cols-6 her çocuğa eşit pay verir, .row-cols-auto ise içeriğe göre boyutlandırır.

Önizleme
Düzenlenebilir HTML

Ekran büyüdükçe sütun sayısını değiştirmek için breakpoint'lerle birleştirin, örneğin row-cols-2 lg:row-cols-3.

İç içe yerleşim

Bir sütun kendi .row'unu barındırabilir. İç içe satır, sütunun içinde yeni bir 12 dilimlik grid başlatır, böylece bir alanı istediğiniz kadar bölebilirsiniz.

Önizleme
Düzenlenebilir HTML

Hizalama ve sıralama

.row sıradan bir flex container'dır, bu yüzden Tailwind'in kendi flexbox yardımcı sınıfları ona uygulanır: items-*, justify-*, self-* ve order-*. Eklenti bunları yeniden tanımlamaz.

Önizleme
Düzenlenebilir HTML

order-2 md:order-1 tarzı yer değiştirmeler yaygın bir kalıptır: telefonda bir sırayla dizin, büyük ekranlarda ters çevirin.

Sağdan sola

Container'a ya da tüm sayfa için <html> üzerine dir="rtl" verin, grid sağdan akmaya başlar. Arapça, Farsça, İbranice ve diğer RTL diller için kullanılacak olan budur.

Önizleme
Düzenlenebilir HTML

Yapılandırılacak bir şey yok. Satırın gutter'ları simetriktir ve offset'ler mantıksal özellikler kullanır, bu yüzden kendiliğinden yön değiştirirler.

Bilmekte fayda var

Sağdan sola

dir="rtl" ekleyin, grid kendini yansıtır. Yapılandırılacak bir şey yoktur.

Tüm sayfa için

index.html
<html dir="rtl">
  ...
</html>

Tek bir bölüm için

index.html
<div class="container" dir="rtl">
  <div class="row">
    <div class="col-6 offset-3">Starts from the right</div>
  </div>
</div>

Neden kendiliğinden çalışıyor

Offset'ler margin-inline-start kullanır, satırın negatif margin'leri ve sütunların iç boşluğu da simetriktir, bu yüzden kendiliğinden yön değiştirirler. Görmek için yukarıdaki herhangi bir örnekte RTL düğmesini kullanın.

Bilmekte fayda var

Sıkça sorulan sorular

En çok sorulan soruların yanıtları.

Hayır. Tailwind'in container'ı breakpoint başına maksimum genişlikleri sağlamaya devam eder. Eklenti bunun üstüne ortalama ve gutter'a duyarlı iç boşluk ekler. İstemiyorsanız generateContainers değerini false yapın.

Evet, amaç tam olarak bu. .row bir flex container'dır, bu yüzden items-center, justify-between, order-2, mt-4 ve diğerleri ona ve sütunlarına her zamanki gibi uygulanır.

Tailwind yalnızca kaynak dosyalarınızda bulabildiği sınıflar için CSS üretir. Kendi projenizde bu otomatiktir. Bu sayfadaki düzenlenebilir örnekler her şeyi içerebileceği için demo, eklentinin her sınıfını ve breakpoint'ini önceden üretir.

Hayır. CDN betiği eklentileri npm'den yükleyemez. Vite, PostCSS, Webpack ya da Tailwind CLI gibi bir derleme düzeni kullanın.

Tailwind v3.4 ve v4, Node 18 veya daha yenisinde. Paket, TypeScript tipleriyle birlikte ESM ve CommonJS derlemeleri sunar.

Sınıf adları birbirine yakın: col-md-6 md:col-6 olur ve gutter sayıları Tailwind ölçeğini izler. Geçiş rehberinde tam eşleme ve kodunuzu dönüştüren bir komut var.

Bir hata mı buldunuz ya da bir fikriniz mi var?

GitHub'da bir issue açın (yeni sekmede açılır) ya da bir pull request (yeni sekmede açılır) gönderin. Küçük düzeltmeler ve dokümantasyon iyileştirmeleri çok makbuldür.