Rehber
Bootstrap Grid'inden Tailwind CSS'e Geçiş
Bir yerleşimi Bootstrap'in grid'inden Tailwind'e taşımak beş adım sürer ve işin çoğu tek bir komutla halledilir. Bu rehber nelerin değiştiğini, sınıfların nasıl eşlendiğini ve bir betiğin sizin yerinize yapamayacağı birkaç şeyi anlatır.
Beş adımda geçiş
Eklentiyi kurun
tw-bootstrap-grid'i kurun ve Tailwind yapılandırmanıza kaydedin. Kurulum rehberinde Tailwind v3 ve v4 için kodlar var.
Bootstrap'in breakpoint'lerini eşleyin (isteğe bağlı)
Yerleşimlerin eskisiyle aynı genişliklerde değişmesini istiyorsanız Tailwind'in ekranlarını 576, 768, 992, 1200 ve 1400px olarak ayarlayın. Aşağıdaki breakpoint'lere bakın.
Sınıfları yeniden adlandırın
Çalışmanızı commit edin, sonra aşağıdaki Perl komutunu çalıştırın. Gutter'ları yeniden numaralandırır ve Bootstrap'in
col-md-6sınıfınımd:col-6yapar.Komutun yapamadıklarını düzeltin
mb-3gibi boşluk sınıflarınımb-4yapın, Bootstrap'in display ve flex sınıflarını Tailwind'inkilerle değiştirin vecontainer-mdgibi sınıfları değiştirin.Bootstrap'in CSS'ini kaldırın ve sonucu kontrol edin
Bootstrap stil dosyasını çıkarın, sonra sayfalarınıza telefon, tablet ve masaüstü genişliklerinde göz atın.
Neler değişiyor, neler değişmiyor
Değişmeyenler
Yapı aynı:
.container,.row,.col-*,.offset-*,.row-cols-*. CSS değişkenlerinin adları bile aynı kalır,--bs-gutter-xve--bs-gutter-y. Bu yüzden onları okuyan özel CSS çalışmaya devam eder.Ön ek, ara ek değil
Bootstrap
col-md-6yazar. Tailwindmd:col-6yazar. 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'ü buradag-4'tür. Breakpoint genişlikleri de biraz farklıdır.
Aynı yerleşim, önce ve sonra
Bootstrap 5
<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
<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>Sınıf eşleme
Responsive sınıflar
| Bootstrap | Burada | Notlar |
|---|---|---|
col-md-6 | md:col-6 | Tailwind breakpoint'i öne, ön ek olarak koyar. |
col-lg | lg:col | Eşit genişlikli sütun için de aynı. |
col-xl-auto | xl:col-auto | |
offset-md-3 | md:offset-3 | |
row-cols-md-3 | md:row-cols-3 | |
g-md-4 | md:g-6 | Sayı da değişir, aşağıdaki gutter boyutlarına bakın. |
col-xxl-4 | 2xl:col-4 | Bootstrap'in xxl'i Tailwind'de 2xl olarak adlandırılır. |
order-md-2 | md:order-2 | order-* Tailwind'e aittir ve 12'ye kadar gider. |
Gutter boyutları
| Bootstrap | Burada | Boyut |
|---|---|---|
g-0 | g-0 | 0 |
g-1 | g-1 | 0.25rem |
g-2 | g-2 | 0.5rem |
g-3 | g-4 | 1rem |
g-4 | g-6 | 1.5rem |
g-5 | g-12 | 3rem |
Tailwind'den gelen yardımcı sınıflar
| Bootstrap | Burada | Notlar |
|---|---|---|
d-flex | flex | |
d-none d-md-block | hidden md:block | |
justify-content-between | justify-between | |
align-items-center | items-center | |
align-self-end | self-end | |
mb-3, p-3 | mb-4, p-4 | Boşluk yardımcı sınıfları da gutter'larla aynı şekilde kayar. |
Bootstrap'in breakpoint'lerini eşleyin
Bootstrap'in breakpoint'leri 576, 768, 992, 1200 ve 1400px'tir. Tailwind'inkiler 640, 768, 1024, 1280 ve 1536px'tir, bu yüzden bir yerleşim geçişten sonra biraz daha erken ya da geç değişebilir. Bu önemliyse Tailwind'in ekranlarını Bootstrap'in değerlerine ayarlayın.
Tailwind v4
@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 */
}Tailwind'in container'ı üzerinde durduğu breakpoint kadar geniştir, bu yüzden maksimum genişlikleri 576, 768, 992, 1200 ve 1400px olur. Bu, Bootstrap'in 540, 720, 960, 1140 ve 1320px değerlerine yakındır ama birebir aynı değildir.
Toplu yeniden adlandırma
Bu Perl komutu gutter'ları yeniden numaralandırır, col-md-6 sınıfını md:col-6, col-xxl-4 sınıfını 2xl:col-4 ve eski no-gutters sınıfını g-0 yapar. Dosyaları yerinde değiştirir, bu yüzden önce commit edin, sonra farkı (diff) okuyun.
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')Bir kez çalıştırın ve sonucu kontrol edin
mb-3 ya da p-3 gibi boşluk sınıfları elle düzeltilmelidir. Desen, yorum satırları dahil sınıfa benzeyen her metne uyar.Taşınmayanlar
.container ve .container-fluid ekler, bu yüzden Bootstrap'in .container-sm, .container-md ve diğer responsive container'ları dahil değildir. İhtiyacınız olursa Tailwind'in max-w-* yardımcı sınıflarıyla kurun. Bootstrap'in diğer yardımcı sınıfları (display, flex, boşluk, metin) yukarıdaki son tabloda olduğu gibi Tailwind'inkilerle değiştirilir.