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ş

  1. Eklentiyi kurun

    tw-bootstrap-grid'i kurun ve Tailwind yapılandırmanıza kaydedin. Kurulum rehberinde Tailwind v3 ve v4 için kodlar var.

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

  3. 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-6 sınıfını md:col-6 yapar.

  4. Komutun yapamadıklarını düzeltin

    mb-3 gibi boşluk sınıflarını mb-4 yapın, Bootstrap'in display ve flex sınıflarını Tailwind'inkilerle değiştirin ve container-md gibi sınıfları değiştirin.

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

Aynı yerleşim, önce ve sonra

Bootstrap 5

index.html
<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

index.html
<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

Responsive sınıflar
BootstrapBuradaNotlar
col-md-6md:col-6Tailwind breakpoint'i öne, ön ek olarak koyar.
col-lglg:colEşit genişlikli sütun için de aynı.
col-xl-autoxl:col-auto
offset-md-3md:offset-3
row-cols-md-3md:row-cols-3
g-md-4md:g-6Sayı da değişir, aşağıdaki gutter boyutlarına bakın.
col-xxl-42xl:col-4Bootstrap'in xxl'i Tailwind'de 2xl olarak adlandırılır.
order-md-2md:order-2order-* Tailwind'e aittir ve 12'ye kadar gider.

Gutter boyutları

Gutter boyutları
BootstrapBuradaBoyut
g-0g-00
g-1g-10.25rem
g-2g-20.5rem
g-3g-41rem
g-4g-61.5rem
g-5g-123rem

Tailwind'den gelen yardımcı sınıflar

Tailwind'den gelen yardımcı sınıflar
BootstrapBuradaNotlar
d-flexflex
d-none d-md-blockhidden md:block
justify-content-betweenjustify-between
align-items-centeritems-center
align-self-endself-end
mb-3, p-3mb-4, p-4Boş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

main.css
@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.

terminal
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

İkinci kez çalıştırmak gutter'ları yeniden numaralandırır. Ayrıca yalnızca yukarıdaki sınıf adlarını bilir, bu yüzden 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

Eklenti yalnızca .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.

Devam edin