Tailwind CSS v4 הוא שכתוב מלא של ה-framework עם תהליך התקנה חדש לחלוטין. אם השתמשתם ב-Tailwind v3 בתבנית וורדפרס בעבר, תשכחו מכל מה שידעתם על tailwind.config.js ועל דירקטיבות מסוג @tailwind – גרסה 4 מחליפה את כל זה.
מדריך זה ילווה אתכם בהתקנת Tailwind CSS v4 בתבנית וורדפרס מאפס באמצעות ה-Tailwind CLI.
אם אתם מעבירים לוורדפרס אפליקציה שלמה שנבנתה עם AI (v0, Lovable ו-Bolt מייצרים כולם קוד Tailwind), תנו מבט במדריך שלי על המרת אב טיפוס שנבנה עם AI לוורדפרס. ואם המקור הוא עיצוב ב-Figma, זה בדיוק מה שאני עושה במסגרת שירות מ-Figma לוורדפרס.
לאחרונה העברתי תבנית מ-v3 ל-v4, וכל העבודה ארכה כעשר דקות. התהליך קצר ופשוט יותר מאשר ב-v3, אבל השלבים שונים מספיק כדי שלא תוכלו פשוט לשדרג את הגרסה הקיימת.
חדשים ב-Tailwind? מדובר ב-framework מסוג utility-first.
במקום לכתוב קובץ CSS, אתם מעצבים אלמנטים ישירות בקבצי התבנית באמצעות קלאסים קטנים, שלכל אחד מהם יש תפקיד אחד, כמו p-4, bg-blue-500 או md:grid-cols-3. תהליך ה-build סורק את הקבצים בחיפוש אחר אותם קלאסים ומייצר קובץ CSS שמכיל רק את ה-CSS בו אתם באמת משתמשים.
מה השתנה ב-Tailwind CSS v4
הנה השינויים בין v3 ל-v4 שמשפיעים על תהליך ההתקנה:
- אין יותר
tailwind.config.js– הקונפיגורציה מתבצעת כעת ב-CSS באמצעות@theme, במקום בקובץ JavaScript. - אין יותר דירקטיבות
@tailwind– במקום שלוש דירקטיבות נפרדות, כותבים שורה אחת בלבד:@import "tailwindcss";. - זיהוי תוכן אוטומטי – Tailwind v4 מאתר את קבצי התבנית שלכם באופן אוטומטי. אין צורך להגדיר נתיבי תוכן.
- חבילת CLI חדשה – ה-CLI עבר מ-
tailwindcssל-@tailwindcss/cli. - אין
npx tailwindcss init– אין שלב אתחול, כי אין קובץ קונפיגורציה שצריך ליצור.
נכון לאמצע 2026, סדרת הגרסאות הנוכחית היא v4.3, ושום דבר מהאמור לעיל לא השתנה: תהליך ההתקנה שבהמשך זהה לזה של v4.0. גרסאות הביניים הוסיפו בעיקר utilities חדשים, כמו צלליות טקסט ומסכות (masks) ב-v4.1, ו-utilities של scrollbar ו-zoom ב-v4.3.
דרישות מקדימות
לפני שמתחילים, ודאו שיש לכם את הדברים הבאים:
- Node.js (גרסה 20 ומעלה): Tailwind CSS v4 דורש Node.js 20+. בדקו את הגרסה שלכם באמצעות הרצת
node -vבטרמינל. אם אתם צריכים להתקין או לעדכן, הורידו אותו מהאתר הרשמי של Node.js או עקבו אחר השלבים בחלק ״התקנת Node.js״ בהמשך. - עורך קוד: VS Code או כל עורך שנוח לכם לערוך בו את קבצי התבנית.
- תבנית וורדפרס: תבנית מותאמת קיימת או תבנית התחלתית. כל תבנית שיש לכם גישה לקבצים שלה תתאים.
מתחילים מאפס? הורידו תבנית התחלתית ריקה מ-underscores.me והתקינו אותה על אתר וורדפרס מקומי.
לאחר מכן מחקו את קובץ ה-package.json של התבנית. הוא שייך ל-build הישן של underscores המבוסס על Sass, והתלות node-sass שבו נכשלת בהתקנה על גרסאות Node עדכניות, דבר ששובר את שלב 1.
גם תבניות אחרות מגיעות עם package.json (כמו Twenty Twenty-Five), ושלב 1 מתקין את כל מה שמופיע בו יחד עם Tailwind.
שימו לב – אל תוסיפו Tailwind לתבנית שלא אתם בניתם (למשל Twenty Twenty-Five): עדכון התבנית הבא ידרוס את הקבצים שלכם. השתמשו בתבנית בת במקום.
עוד דרישה שקל לפספס: הדפדפנים בהם הגולשים שלכם באמת משתמשים.
התקנת Node.js
דלגו על חלק זה אם node -v כבר מציג גרסה 22 ומעלה. גרסה 20 עדיין מריצה את Tailwind v4, אך היא כבר לא מקבלת עדכוני אבטחה.
נתקלתי בזה במק שעדיין היה מותקן עליו Node 18 מ-Homebrew. אם
node -vמציג גרסה נמוכה מ-20, הדרך המהירה ביותר היאnvm install --lts.
macOS ו-Linux (כולל Ubuntu)
הדרך הקלה ביותר היא nvm (בשמו המלא Node Version Manager), שמאפשר גם לעבור בין גרסאות Node לפי פרויקט.
- התקינו את nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash - הפעילו מחדש את הטרמינל, או טענו את nvm בחלון הנוכחי:
source ~/.nvm/nvm.sh - התקינו את גרסת ה-LTS העדכנית של Node.js. nvm יעבור אליה מיד:
nvm install --lts - ודאו שההתקנה הצליחה:
node -v npm -vשתי הפקודות אמורות להציג מספר גרסה.
ב-Ubuntu, הימנעו מ-sudo apt install nodejs לצורך זה. Ubuntu 24.04 מגיע עם Node 18 במאגרים הרגילים שלו, גרסה ישנה מדי עבור Tailwind v4. nvm מתקין גרסה עדכנית בלי לגעת בחבילת המערכת.
Windows
- הורידו את קובץ ההתקנה של גרסת ה-LTS מ-nodejs.org.
- הריצו את ההתקנה והשאירו את אפשרויות ברירת המחדל.
- פתחו חלון Command Prompt או PowerShell חדש והריצו
node -vו-npm -vלבדיקה.
אם ב-Windows הפקודה node לא מזוהה, סגרו את הטרמינל ופתחו חלון חדש: השינוי ב-PATH חל רק על חלונות שנפתחו אחרי ההתקנה.
ב-macOS וב-Linux, אם nvm לא נמצא, בדקו שההתקנה הוסיפה את שורות הטעינה שלו לקובץ ~/.zshrc או ~/.bashrc.
שלב 1 – התקנת Tailwind CSS v4
פתחו את הטרמינל, נווטו לתיקייה הראשית של תבנית הוורדפרס שלכם והריצו:
npm install tailwindcss @tailwindcss/cli
מותקנות שתי חבילות: הספרייה הראשית וה-CLI שמריץ את ה-build. זה הכל. אין init, אין קובץ קונפיגורציה.
לאחר סיום ההתקנה, תראו תיקיית node_modules וקובץ package.json בתיקיית התבנית שלכם.
שלב 2 – יצירת קובץ ה-CSS
צרו תיקייה בשם src בתיקייה הראשית של התבנית. בתוכה, צרו קובץ בשם input.css עם שורה אחת בלבד:
@import "tailwindcss";
שורה זו מחליפה את שלוש דירקטיבות ה-@tailwind שגרסה 3 דרשה (@tailwind base, @tailwind components, @tailwind utilities). Tailwind v4 מטפל בכל זה באמצעות import אחד.
שלב 3 – הפעלת תהליך ה-Build
הריצו את הפקודה הבאה מהתיקייה הראשית של התבנית:
npx @tailwindcss/cli -i ./src/input.css -o ./dist/output.css --watch
פקודה זו מורה ל-Tailwind לקרוא את src/input.css, לסרוק את קבצי התבנית שלכם בחיפוש אחר קלאסים ולייצא את ה-CSS המקומפל ל-dist/output.css. הדגל --watch משאיר את התהליך פעיל, כך שה-CSS מקומפל מחדש אוטומטית בכל שינוי.
--watch חייב לרוץ כדי ש-Tailwind יזהה קלאסים חדשים וייצר מחדש את ה-CSS.מה לגבי נתיבי תוכן?
ב-v3, הייתם צריכים להגדיר ידנית אילו קבצים Tailwind צריך לסרוק ב-tailwind.config.js. ב-v4, Tailwind מזהה את קבצי התבנית שלכם באופן אוטומטי. הוא מדלג על כל מה שמופיע בקובץ ה-.gitignore שלכם ועל קבצים בינאריים, כך שהוא לא יסרוק את node_modules או תמונות.
אם אתם צריכים לכלול מקור ש-Tailwind לא מזהה אוטומטית (למשל קבצי תבנית בתוך תוסף), הוסיפו אותו באמצעות הדירקטיבה @source בקובץ ה-CSS שלכם.
הנתיב הוא יחסי לקובץ ה-CSS, כך שמתוך wp-content/themes/your-theme/src/input.css תיקיית התוסף נמצאת שלוש רמות למעלה:
@import "tailwindcss";
@source "../../../plugins/my-plugin/templates";
זה עובד גם בכיוון ההפוך. בכדי למנוע מ-Tailwind לסרוק תיקייה מסוימת (למשל קבצי תבנית ישנים שכבר לא נטענים), השתמשו ב-@source not (מגרסה v4.1 ואילך):
@source not "../template-parts/legacy";
שלב 4 – טעינת ה-CSS בוורדפרס
כעת טענו את קובץ ה-CSS המקומפל בתבנית. פתחו את קובץ functions.php של התבנית והוסיפו:
function theme_tailwind_styles() {
wp_enqueue_style(
'tailwind',
get_template_directory_uri() . '/dist/output.css',
array(),
filemtime( get_template_directory() . '/dist/output.css' )
);
}
add_action( 'wp_enqueue_scripts', 'theme_tailwind_styles' );
השימוש ב-filemtime() כפרמטר הגרסה מוודא שה-cache של הדפדפן מתעדכן בכל פעם שקובץ ה-CSS משתנה. כך לא תצטרכו לנקות cache ידנית במהלך הפיתוח.
אם שיטת ה-enqueue חדשה לכם, יש מדריך מפורט על הוספת קבצי CSS ו-JavaScript באתרי וורדפרס.
שלב 5 – התחילו להשתמש ב-Tailwind
פתחו קובץ תבנית כלשהו (למשל header.php, index.php או template part) והוסיפו קלאס של Tailwind לבדיקה.
בתבנית בלוקים אין קבצי תבנית ב-PHP: הוסיפו את הקוד בבלוק Custom HTML בתוך parts/header.html או באחד הקבצים בתיקייה templates/. לדוגמה:
<div class="bg-blue-500 text-white p-8 text-center">
<h1 class="text-3xl font-bold">Tailwind v4 is working!</h1>
</div>
ודאו שתהליך ה---watch עדיין רץ בטרמינל, ואז רעננו את הדף. אתם אמורים לראות קופסה כחולה עם טקסט לבן.
דוגמה: Grid כרטיסים רספונסיבי
הנה דוגמה מציאותית יותר – grid כרטיסים רספונסיבי המציג את הכרטיסים זה מתחת לזה במובייל ובשלוש עמודות במסכים בינוניים:
<div class="mx-auto max-w-5xl p-6">
<div class="grid grid-cols-1 gap-6 md:grid-cols-3">
<div class="rounded-lg bg-white p-6 shadow-lg">
<h2 class="mb-2 text-xl font-bold">Card One</h2>
<p class="text-gray-600">Content for the first card goes here.</p>
</div>
<div class="rounded-lg bg-white p-6 shadow-lg">
<h2 class="mb-2 text-xl font-bold">Card Two</h2>
<p class="text-gray-600">Content for the second card goes here.</p>
</div>
<div class="rounded-lg bg-white p-6 shadow-lg">
<h2 class="mb-2 text-xl font-bold">Card Three</h2>
<p class="text-gray-600">Content for the third card goes here.</p>
</div>
</div>
</div>
דוגמה: Hero Section ממורכז
הנה דוגמה נוספת, Hero Section ממורכז עם כותרת, תיאור קצר וכפתור:
<div class="bg-blue-500 py-20 text-white">
<div class="container mx-auto px-4 text-center">
<h1 class="mb-4 text-4xl font-bold">Welcome to Tailwind CSS</h1>
<p class="mb-8 text-lg">Tailwind CSS is a utility-first CSS framework for rapid UI development.</p>
<a href="#" class="rounded-md bg-white px-4 py-2 font-semibold text-blue-500">Get Started</a>
</div>
</div>
התאמה אישית של התבנית עם CSS
ב-v3, התאמתם צבעים, פונטים ומרווחים ב-tailwind.config.js. ב-v4, עושים זאת ישירות בקובץ ה-CSS באמצעות הדירקטיבה @theme:
@import "tailwindcss";
@theme {
--color-brand: #a3316f;
--color-brand-dark: #8a2a5e;
--font-heading: "Inter", sans-serif;
--font-body: "IBM Plex Sans", sans-serif;
--breakpoint-3xl: 120rem;
--radius-card: 1.25rem;
}
לאחר הוספת הערכים, תוכלו להשתמש בהם כקלאסים: bg-brand, text-brand-dark, font-heading, font-body, 3xl:grid-cols-4 ו-rounded-card. כל משתני ה-theme חשופים גם כ-CSS custom properties, כך שתוכלו לגשת אליהם מכל מקום עם var(--color-brand).
שימו לב ש-@theme רק מעניק שמות לפונטים. את הפונטים עצמם עדיין צריך לטעון, בין אם באמצעות טעינת קובץ ה-CSS של הפונט ובין אם באמצעות אחסון קבצי הפונט על השרת שלכם.
מרווחים (spacing) אינם דורשים הגדרה כלל. ב-v4 כל ה-utilities של המרווחים נגזרים ממשתנה אחד, --spacing (ברירת המחדל היא 0.25rem), כך שערכים מחוץ לסקאלה הישנה כמו p-13 או mt-17 עובדים מיד.
קלאסים שנבנים ב-PHP או ב-ACF
Tailwind מוצא קלאסים על ידי קריאת הקבצים שלכם כטקסט פשוט. הוא אף פעם לא מריץ PHP, ולכן שם קלאס שמורכב בזמן ריצה לא ייכלל ב-CSS:
<?php $color = get_field( 'accent_color' ); // "red", "green" or "blue" ?>
<p class="text-<?php echo esc_attr( $color ); ?>-600">Accent text</p>
Tailwind לא רואה את text-red-600 בקובץ זה, ולכן הקלאס לא קיים בקובץ הסופי. הפתרון הנקי ביותר הוא לשמור את שמות הקלאסים המלאים בתוך הקובץ, במקום שבו הסורק יכול למצוא אותם:
<?php
$accent_classes = array(
'red' => 'bg-red-100 text-red-800',
'green' => 'bg-green-100 text-green-800',
'blue' => 'bg-blue-100 text-blue-800',
);
$color = get_field( 'accent_color' );
$class = $accent_classes[ $color ] ?? 'bg-gray-100 text-gray-800';
?>
<p class="<?php echo esc_attr( $class ); ?>">Accent text</p>
כששמות הקלאסים לא יכולים להופיע בקובץ PHP (למשל כשעורכי תוכן מקלידים אותם בשדה, או בתיבה ״Additional CSS class(es)״ של עורך הבלוקים), הוסיפו אותם ל-safelist בקובץ ה-CSS עם @source inline() (מגרסה v4.1 ואילך). Tailwind פורס את הסוגריים המסולסלים לכל הצירופים האפשריים, כך ששורה אחת מכסה את כולם:
@source inline("text-{red,green,blue}-700");
Utilities מותאמים
השתמשו ב-@utility עבור קלאסים משלכם. בניגוד לקלאס CSS רגיל, utility שנרשם כך עובד עם variants, כך שגרסאות hover: ו-md: מגיעות בחינם:
@utility content-auto {
content-visibility: auto;
}
כעת תוכלו לכתוב content-auto או md:content-auto בקבצי התבנית.
תוספים (Plugins)
תוספים נטענים עם @plugin. התוסף לו זקוקות רוב תבניות הוורדפרס הוא תוסף ה-typography הרשמי.
הקלאס prose שלו מעצב את ה-HTML שהפונקציה the_content() מדפיסה (כותרות, רשימות, ציטוטים וטבלאות) בלי להוסיף קלאס לכל אלמנט. התקינו אותו:
npm install @tailwindcss/typography
טענו אותו בקובץ ה-CSS:
@plugin "@tailwindcss/typography";
ועטפו את תוכן הפוסט בקובץ התבנית:
<article class="prose lg:prose-xl">
<?php the_content(); ?>
</article>
Dark Mode מבוסס קלאס
כברירת מחדל, utilities מסוג dark: עוקבים אחר הגדרת מערכת ההפעלה של הגולש (prefers-color-scheme). אם בתבנית שלכם יש מתג שמוסיף קלאס dark לאלמנט ה-<html>, הגדירו מחדש את ה-variant:
@custom-variant dark (&:where(.dark, .dark *));
כעת dark:bg-gray-900 יחול רק כשהקלאס dark קיים.
פיצול הקונפיגורציה לקבצים
ככל שהתבנית גדלה, העבירו את בלוק ה-@theme לקובץ נפרד וייבאו אותו אחרי Tailwind:
/* src/input.css */
@import "tailwindcss";
@import "./theme.css";
קובץ ה-theme.css יכיל רק את בלוק ה-@theme { ... }, ותוכלו להוסיף קבצים נוספים באותה דרך עבור utilities או הגדרות של תוספים.
הוספת סקריפט Build ל-package.json
במקום להקליד את כל פקודת ה-CLI בכל פעם, הוסיפו סקריפט build ל-package.json שלכם:
{
"scripts": {
"dev": "npx @tailwindcss/cli -i ./src/input.css -o ./dist/output.css --watch",
"build": "npx @tailwindcss/cli -i ./src/input.css -o ./dist/output.css --minify"
}
}
אם כבר קיים ב-package.json סקריפט בשם build (ב-Twenty Twenty-Five יש כזה עבור ה-CSS של התבנית), תנו לסקריפט שלכם שם אחר, למשל build:css, כדי לא לדרוס אותו.
כעת תוכלו להריץ npm run dev בזמן הפיתוח ו-npm run build עבור build מכווץ (minified) לפני העלאה לפרודקשן.
בזמן העלאה לשרת, מספיקים קבצי התבנית והקובץ dist/output.css. אל תעלו את node_modules: בתבנית הבדיקה שלי התיקייה שקלה כ-19 MB.
פתרון בעיות
בעיות נפוצות שאתם עלולים להיתקל בהן:
- שגיאת גרסת Node.js: Tailwind v4 דורש Node.js 20+. הריצו
node -vושדרגו במידת הצורך. אם אתם משתמשים ב-nvm, הריצוnvm install --lts. - הסגנונות לא מופיעים: ודאו שתהליך ה-
--watchרץ. בדקו ש-dist/output.cssקיים ונטען בדפדפן (בדקו את קוד המקור של הדף). - קלאסים לא מזוהים: Tailwind v4 משתמש בזיהוי תוכן אוטומטי המבוסס על ה-
.gitignoreשלכם. אם התבניות שלכם נמצאות במיקום לא סטנדרטי, השתמשו בדירקטיבה@sourceבקובץ ה-CSS כדי לכלול אותן. - הקלאסים נוצרים אבל לא חלים: ה-CSS הקיים של התבנית גובר עליהם. ההסבר מופיע מתחת לרשימה.
- שימוש בתבנית בת: אם התבנית שלכם היא תבנית בת, החליפו את
get_template_directory_uri()ב-get_stylesheet_directory_uri()בפונקציית ה-enqueue כך שתצביע על תיקיית תבנית הבת.
למה ה-CSS של התבנית גובר? Tailwind v4 מכניס את ה-utilities שלו ל-cascade layer, וכל CSS שאינו בתוך layer (למשל קובץ ה-style.css הקיים של התבנית) גובר עליהם, בלי קשר ל-specificity. בבדיקה שלי עם underscores, הכלל h1 { font-size: 2em; } שלו גבר על text-3xl.
בתבנית קלאסית, הפסיקו לטעון את קובץ העיצוב הישן, או העבירו את הכללים שלו לקובץ שאתם מייבאים מתחת ל-utilities:
@import "tailwindcss";
@import "./legacy.css" layer(base);
השאירו ב-style.css את ההערה שבראש הקובץ, ממנה וורדפרס קורא את שם התבנית.
בתבניות בלוקים הבעיה חמורה יותר. ב-Twenty Twenty-Five, ה-global styles שוורדפרס מייצר מתוך theme.json גברו גם על text-3xl וגם על font-bold, ואותם אי אפשר להעביר ל-layer.
במקרה כזה סמנו את ה-utilities כ-important, לכל קלאס בנפרד עם ! בסופו (text-3xl!) או לכולם יחד:
@import "tailwindcss" important;
שאלות נפוצות
שאלות נפוצות על Tailwind CSS v4 בוורדפרס:
tailwind.config.js ב-v4?
@theme. אין צורך ליצור או לתחזק קובץ קונפיגורציה ב-JavaScript.
node -v בטרמינל. אם אתם צריכים לשדרג, השתמשו ב-nvm או הורידו את גרסת ה-LTS העדכנית מ-nodejs.org.
.gitignore וסוגי קבצים בינאריים כמו תמונות. אם אתם צריכים לכלול קבצים מחוץ לטווח ברירת המחדל, השתמשו בדירקטיבה @source בקובץ ה-CSS שלכם.
npx @tailwindcss/upgrade. הוא מטפל ברוב המיגרציה באופן אוטומטי, כולל המרת קובץ הקונפיגורציה ועדכון הדירקטיבות. עבור תבניות וורדפרס, ייתכן שתצטרכו לעדכן ידנית את פונקציית ה-enqueue ופקודת ה-CLI.
@tailwindcss/cli כדי לקמפל את ה-CSS ישירות מהטרמינל. שיטת PostCSS משתמשת ב-@tailwindcss/postcss כתוסף PostCSS, והיא מתאימה יותר לפרויקטים שכבר יש בהם pipeline של PostCSS. עבור רוב תבניות הוורדפרס, שיטת ה-CLI פשוטה יותר ומומלצת.
סיכום
כל ההגדרה לוקחת ארבעה שלבים ומספר דקות. בהשוואה ל-v3, ההקלה הגדולה ביותר היא שלא צריך לחשוב על נתיבי תוכן או לתחזק קובץ קונפיגורציה נפרד.
אם אתם רוצים להעמיק בהתאמה אישית, ה-תיעוד הרשמי של Tailwind CSS v4 מכסה הכל.
רוצים לראות את אותה הגדרה עובדת באתר אמיתי? ראו את הקייס סטאדי של 7is, תבנית וורדפרס בעברית ובאנגלית על Tailwind v4, שבה שני stylesheets ישנים הוחלפו בקובץ tailwind.css אחד במשקל 68.1 KB, בלי build נפרד ל-RTL.
בבנייה מחדש של GN Law אותה גישה הסתפקה ב-stylesheet אחד של 24 KB לאתר עברי שלם, במקום תשעה קבצים במשקל כולל של 203 KB.