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.
.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.
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.
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ı
Öncelik
CSS değişkeni
Seçenek
Notlar
1
--bs-row-gutter-x / --bs-container-gutter-x
rowGutters / containerGutters
En belirli değer kazanır.
2
--bs-global-gutter-x
gutters
İkisi için ortak yedek değer.
3
1.5rem (x) ve 0 (y)
yerleşik varsayılan
Bootstrap'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 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ıf
Ne yapar
Notlar
.container
width: 100%; ortalı; iç boşluk gutter'dan gelir
Maksimum genişlik Tailwind'in breakpoint'lerinden gelir.
.container-fluid
.container ile aynı
Her breakpoint'te tam genişlik.
.row
display: flex; flex-wrap: wrap; negatif margin
Dış gutter'ı iptal eder ve çocuklarını yerleştirir.
Sütunlar
Sütunlar sınıfları
Sınıf
Ne yapar
Notlar
.col
flex: 1 0 0%
Kalan alanı eşit paylaşır.
.col-auto
flex: 0 0 auto; width: auto
İçeriğine göre boyutlanır.
.col-1 … .col-12
flex: 0 0 auto; width: n / 12
12 dilimden n tanesini kaplar.
Offset'ler ve row sütunları
Offset'ler ve row sütunları sınıfları
Sınıf
Ne yapar
Notlar
.offset-0 … .offset-12
margin-inline-start: n / 12
RTL'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ıf
Ne yapar
Notlar
.g-*
--bs-gutter-x ve --bs-gutter-y
Her iki yön.
.gx-*
--bs-gutter-x
Yalnızca yatay.
.gy-*
--bs-gutter-y
Yalnı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.
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-6md: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.