Tailwind 4 ga o'tish: konfiguratsiya fayli qayerga g'oyib bo'ldi
Tailwind 4 ga o'tganimda birinchi savolim shu bo'ldi: tailwind.config.ts qani?
Javob — u yo'q. Butunlay. Va bu xato emas, bu asosiy g'oya.
Tailwind 3 da sizda ikki dunyo bor edi: dizayn tokenlari JavaScript konfiguratsiyasida, uslublar esa CSS'da. Tailwind 4 ularni birlashtirdi — endi hammasi CSS ichida yashaydi. Bu birinchi kuni g'alati tuyuladi, keyin esa mantiqiy ko'rina boshlaydi.
Bu maqola shu migratsiyaning amaliy tomoni haqida: nima o'zgaradi, nima buziladi va nimani oldindan bilish kerak.
Nima o'zgaradi
Ilgari ranglaringiz shunday yashardi:
// tailwind.config.ts
export default {
theme: {
extend: {
colors: {
ink: '#0B0B0F',
signal: '#3B82F6',
},
},
},
}Endi shunday:
/* globals.css */
@import "tailwindcss";
@theme {
--color-ink: #0B0B0F;
--color-signal: #3B82F6;
}Sintaksis boshqa, natija bir xil: bg-signal, text-ink klasslari avvalgidek ishlaydi.
Lekin bitta muhim farq bor. @theme ichida e'lon qilingan har bir token bir vaqtning o'zida haqiqiy CSS o'zgaruvchisi bo'ladi. Ya'ni siz uni Tailwind klasslarisiz ham ishlata olasiz:
.custom-shadow {
box-shadow: 0 2px 12px var(--color-ink);
}Tailwind 3 da buning uchun tokenni ikki joyda — konfiguratsiyada va CSS o'zgaruvchisida — takrorlash kerak edi. Endi manba bitta. Menda bu "CSS-first" g'oyaning eng aniq foydasi bo'ldi.
Fontlar bilan bog'liq tuzoq
Eng ko'p vaqtimni olgan joy — fontlar. Sabab shundaki, next/font sizga tayyor rang emas, o'zgaruvchi beradi:
import { Golos_Text } from 'next/font/google'
const golos = Golos_Text({
subsets: ['latin'],
variable: '--font-golos',
})Endi buni @theme ga qo'shmoqchisiz. Va oddiy @theme ishlamaydi, chunki u qiymatlarni statik deb hisoblaydi va boshqa o'zgaruvchiga havolani hal qila olmaydi.
Yechim — @theme inline:
@theme inline {
--font-sans: var(--font-golos), system-ui, sans-serif;
--font-display: var(--font-unbounded), sans-serif;
--font-mono: var(--font-jetbrains), monospace;
}inline kalit so'zi Tailwind'ga "bu qiymatni nusxalamay, o'zgaruvchi havolasi sifatida qoldir" deydi. Usiz font klasslari jimgina ishlamay qoladi — xato ham chiqmaydi, shunchaki standart font ko'rinadi.
Qoida: boshqa CSS o'zgaruvchisiga havola qiladigan har qanday token @theme inline da bo'lishi kerak.
Plaginlar va nimadan voz kechish
Migratsiya paytida men uchta paketni butunlay olib tashladim.
Birinchisi — autoprefixer. Tailwind 4 prefikslarni o'zi qo'yadi, alohida qadam kerak emas.
Ikkinchisi — komponent kutubxonasi (menda daisyui edi). Bu ixtiyoriy, lekin men uni ataylab tashladim: tayyor komponentlar tez boshlash uchun yaxshi, keyin esa har bir moslashtirishda ular bilan kurashasiz. O'z dizayn tizimim bor ekan, ular ortiqcha qatlam edi.
Uchinchisi — PostCSS konfiguratsiyasidagi ortiqcha qatorlar. Tailwind 4 da odatda bitta plagin yetadi.
Agar sizda uchinchi tomon Tailwind plaginlari bo'lsa, migratsiyadan oldin ularning 4-versiyani qo'llab-quvvatlashini tekshiring. Bu men o'tgan safar Next 16 migratsiyasida yegan saboq: sizni asosiy paket emas, uning atrofidagi ekotizim ushlab qoladi.
Nima buziladi
Amalda menda uch xil narsa tegishli bo'ldi.
Birinchisi — maxsus qiymatlar sintaksisi. Kvadrat qavslar bilan yozilgan joylar (w-[calc(100%-2rem)] kabi) ko'pincha ishlayveradi, lekin ba'zilari tekshirishni talab qiladi.
Ikkinchisi — konfiguratsiyaga tayangan har qanday narsa. Menda tailwind.config.ts dan token o'qiydigan bitta yordamchi bor edi. U endi ishlamaydi, chunki fayl yo'q. Buni CSS o'zgaruvchisini o'qishga o'tkazdim.
Uchinchisi — standart ranglar palitrasi. Ba'zi soyalar biroz o'zgargan. Agar dizayningiz aniq ranglarga bog'liq bo'lsa, o'z tokenlaringizni e'lon qiling va standart palitraga tayanmang.
Eng yoqimli tomoni esa shu bo'ldi: kontent yo'llarini (content: [...]) sozlash butunlay kerak emas. Tailwind 4 fayllarni o'zi topadi.
Qorong'i mavzu qayerga ketdi
Tailwind 3 da mavzu darkMode: 'class' sozlamasi bilan boshqarilardi. Konfiguratsiya fayli yo'qolgach, bu sozlama ham yo'qoldi va uning o'rniga variantni o'zingiz e'lon qilasiz:
@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));Bir qarashda bu ortiqcha ish. Amalda esa u foydaliroq chiqdi, chunki endi shart sizniki: men class emas, data-theme atributini ishlataman, va tanlovchini xohlaganimcha yozaman.
Bundan tashqari tokenlarni ham mavzu bo'yicha almashtirish mumkin. Buning uchun @theme blokidan tashqarida oddiy CSS yoziladi:
:root {
--color-surface: #FFFFFF;
}
[data-theme="dark"] {
--color-surface: #0B0B0F;
}bg-surface klassi ikkala mavzuda ham ishlaydi va hech qanday dark: prefiksisiz to'g'ri rangni oladi. Bu Tailwind 3 da imkonsiz edi, chunki u yerda tokenlar CSS o'zgaruvchisi emas, build vaqtida hal qilinadigan qiymatlar edi.
Semantik tokenlar: rangni emas, rolni nomlang
Bu Tailwind 4 talabi emas, lekin CSS-first yondashuv uni tabiiy qiladi.
Migratsiya paytida men tokenlarni qayta nomladim. Ilgari ular rang nomi edi, endi vazifa nomi:
@theme {
--color-ink: #0B0B0F;
--color-signal: #3B82F6;
}
:root {
--color-surface: #FFFFFF;
--color-text: var(--color-ink);
--color-accent: var(--color-signal);
--color-border: #E5E5EA;
}Yuqori qismda palitra — xom ranglar. Pastda rollar — ular palitraga havola qiladi.
Farqi amalda ko'rinadi. Agar aksent rangini almashtirmoqchi bo'lsangiz, bitta qatorni o'zgartirasiz. Agar komponentlarda to'g'ridan-to'g'ri text-signal yozilgan bo'lsa, o'nlab faylni qidirib chiqasiz.
Amaliy qoida: komponentlarda faqat rol nomlarini ishlating. Xom rang nomi faqat palitra e'lonida uchrasin. Bu oddiy intizom dizayn tizimini keyinchalik o'zgartirishni bir necha barobar arzonlashtiradi.
Migratsiya tartibi
Men quyidagi tartibda ketdim va uni tavsiya qilaman:
- Avval
tailwind.config.tsichidagi hamma narsani ro'yxatga oling — ranglar, fontlar, oraliqlar, breakpointlar. Bu sizning haqiqiy dizayn tizimingiz. - Paketni yangilang va PostCSS konfiguratsiyasini soddalashtiring.
globals.cssda@import "tailwindcss"yozing va@themeblokini yarating.- Tokenlarni ko'chiring. Ranglar
--color-*, fontlar--font-*, oraliqlar--spacing-*prefiksi bilan. - Fontlarni
@theme inlinega alohida joylashtiring. - Eski konfiguratsiya faylini o'chiring va
bun run buildni yurgizing. - Saytni ko'zdan kechiring — ayniqsa fontlar va soyalar.
Oxirgi qadam muhim, chunki Tailwind migratsiyasidagi xatolarning aksariyati jimgina bo'ladi: build o'tadi, klass qo'llanmaydi, siz esa buni faqat ko'z bilan ko'rasiz.
Arziydimi
Mening javobim — ha, lekin sabab tezlik emas.
Asosiy foyda konseptual: dizayn tizimingiz endi bitta joyda, o'z tabiiy tilida yashaydi. JavaScript konfiguratsiyasi bilan CSS o'rtasida token takrorlash yo'qoladi. Yangi dasturchi loyihaga kirganda globals.css ni ochadi va butun palitrani ko'radi — alohida konfiguratsiya faylini qidirishi shart emas.
Agar loyihangiz kichik bo'lsa, migratsiya bir soatlik ish. Katta va ko'p plaginli bo'lsa — avval plaginlarni tekshiring, chunki asosiy mehnat aynan o'sha yerdan chiqadi.