Tailwind CSS
Το Blockstudio περιλαμβάνει ενσωματωμένη υποστήριξη Tailwind CSS v4. Όταν είναι ενεργή, κάθε σελίδα frontend μεταγλωττίζεται στον διακομιστή μέσω του TailwindPHP, με αυτόματη προσωρινή αποθήκευση βάσει αρχείων. Στον επεξεργαστή block, ένα συνοδευτικό script Tailwind CDN παρέχει ζωντανή προεπισκόπηση καθώς επεξεργάζεστε.
Χωρίς βήμα build, χωρίς CLI, χωρίς να απαιτείται το Node.js.
Πώς λειτουργεί
Το Blockstudio χρησιμοποιεί δύο ξεχωριστές στρατηγικές μεταγλώττισης ανάλογα με το περιβάλλον:
Frontend (από την πλευρά του διακομιστή)
Σε κάθε αίτημα frontend, το Blockstudio καταγράφει το πλήρες HTML της σελίδας μέσω ενός buffer εξόδου, εξάγει όλους τους υποψήφιους κλάσεων CSS, μεταγλωττίζει μόνο το CSS που χρησιμοποιείται πραγματικά και εισάγει το αποτέλεσμα ως ενσωματωμένο tag <style> πριν από το </head>.
Η ροή μεταγλώττισης:
- Το WordPress αποδίδει το πλήρες HTML της σελίδας σε buffer εξόδου
- Το
TailwindPHP::extractCandidates()σαρώνει το HTML και εξάγει όλα τα πιθανά ονόματα κλάσεων CSS (γρήγορη regex, χωρίς μεταγλώττιση) - Οι ταξινομημένοι υποψήφιοι κατακερματίζονται μαζί με τη διαμόρφωση CSS, ώστε να δημιουργηθεί ένα κλειδί προσωρινής μνήμης
- Σε επιτυχία προσωρινής μνήμης: το μεταγλωττισμένο CSS διαβάζεται από τον δίσκο και εισάγεται
- Σε αστοχία προσωρινής μνήμης: το
TailwindPHP::generate()μεταγλωττίζει το CSS, το γράφει στον φάκελο προσωρινής μνήμης και το εισάγει
Το μεταγλωττισμένο CSS εισάγεται ως εξής:
<style id="blockstudio-tailwind">
/* compiled CSS */
</style>
Περιλαμβάνει το preflight του Tailwind (επαναφορά CSS) και όλες τις αντιστοιχισμένες κλάσεις βοηθητικών εργαλείων.
Επεξεργαστής (από την πλευρά του προγράμματος περιήγησης)
Μέσα στον επεξεργαστή block, ένα συνοδευτικό script Tailwind CDN (έκδοση προγράμματος περιήγησης του Tailwind CSS v4) εκτελείται στην πλευρά του προγράμματος περιήγησης. Παρέχει άμεση ζωντανή προεπισκόπηση καθώς πληκτρολογείτε ονόματα κλάσεων, χωρίς διαδρομές μετάβασης στον διακομιστή. Το CDN φορτώνεται μόνο στον επεξεργαστή και δεν παρέχεται ποτέ στο frontend.
Όταν είναι ενεργό το assets.reset.enabled, το Blockstudio επαναφέρει επίσης τις συνηθισμένες βοηθητικές κλάσεις εμφάνισης και θέσης του Tailwind μέσα στον καμβά του επεξεργαστή. Έτσι, οι κλάσεις σε επίπεδο wrapper, όπως οι flex, grid, absolute, fixed και sticky, δεν αντικαθίστανται από τους κανόνες wrapper block του επεξεργαστή WordPress, με αποτέλεσμα οι διατάξεις που βασίζονται σε βοηθητικές κλάσεις να προσεγγίζουν περισσότερο την εμφάνιση στο frontend.
Ενεργοποίηση του Tailwind
Προσθέστε τη διαμόρφωση tailwind στο blockstudio.json σας:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true
}
}
Ή ενεργοποιήστε το μέσω φίλτρου:
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
Όταν το enabled είναι true, σε κάθε σελίδα frontend θα γίνεται αυτόματα μεταγλώττιση και εισαγωγή του Tailwind CSS. Μπορείτε να χρησιμοποιείτε βοηθητικές κλάσεις Tailwind παντού: σε πρότυπα block, πρότυπα θέματος, φίλτρα the_content ή οποιοδήποτε HTML εμφανίζεται στην έξοδο της σελίδας.
Έξοδος frontend
Το μεταγλωττισμένο CSS ενσωματώνεται εξ ορισμού, διατηρώντας την έξοδο που χρησιμοποιούσαν οι προηγούμενες εκδόσεις. Οι ιστότοποι με πολλούς κοινόχρηστους κανόνες μπορούν να επιλέξουν αντ’ αυτού ένα φύλλο στυλ με hash περιεχομένου:
{
"tailwind": {
"enabled": true,
"output": "link"
}
}
Το "output": "link" εκπέμπει το υπάρχον αρχείο προσωρινής μνήμης tailwind/{content-hash}.css ως <link rel="stylesheet">. Το URL αλλάζει όταν αλλάζει η ταυτότητα χρόνου εκτέλεσης, οι υποψήφιοι, η μηχανή ή η είσοδος CSS, ώστε τα προγράμματα περιήγησης και οι edge caches να μπορούν να διατηρούν με ασφάλεια παλιές διευθύνσεις URL. Ρυθμίστε τον web server ή το CDN να στέλνει κεφαλίδα Cache-Control: public, immutable μεγάλης διάρκειας για αυτό το πεδίο προσωρινής μνήμης.
Η προεπιλεγμένη ρίζα της προσωρινής μνήμης είναι δημόσια, κάτω από το wp-content. Αν το cache.path δείχνει σε έναν ιδιωτικό απόλυτο τόμο, το Blockstudio χρησιμοποιεί ενσωματωμένο CSS, εκτός αν το υπάρχον φίλτρο blockstudio/files/url παρέχει δημόσιο URL για το πεδίο tailwind:
add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope): string {
if ('tailwind' !== $scope) {
return $url;
}
return 'https://static.example.com/blockstudio/' . basename($path);
},
10,
3
);
Βοηθητικές συναρτήσεις σύνθεσης προτύπων
Το Blockstudio παρέχει την ίδια συνοδευτική μηχανή TailwindPHP στα πρότυπα PHP. Δεν απαιτείται αντίγραφο ή εφεδρική υλοποίηση από την πλευρά του θέματος:
$classes = bs_tw_merge('px-2 text-sm', 'px-4');
// text-sm px-4
$button = bs_tw_variants([
'base' => 'inline-flex items-center',
'variants' => [
'size' => [
'sm' => 'h-8 px-3',
'lg' => 'h-12 px-6',
],
],
'defaultVariants' => [
'size' => 'sm',
],
]);
echo $button(['size' => 'lg', 'class' => 'rounded']);
Το bs_tw_merge() δέχεται εμφωλευμένες τιμές κλάσεων και επιλύει αντικρουόμενα βοηθητικά στοιχεία Tailwind. Το bs_tw_variants() επιστρέφει μια κλήσιμη συνάρτηση τύπου CVA που υποστηρίζει βασικές τιμές, παραλλαγές, προεπιλεγμένες παραλλαγές, σύνθετες παραλλαγές, class και className.
Διαμόρφωση
Το Tailwind v4 ακολουθεί μια προσέγγιση διαμόρφωσης με προτεραιότητα στο CSS. Αντί για αρχείο διαμόρφωσης JavaScript, γράφετε τη διαμόρφωση απευθείας ως CSS, χρησιμοποιώντας την οδηγία @theme.
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-primary: #3b82f6; --color-secondary: #10b981; --font-family-heading: 'Inter', sans-serif; }"
}
}
Η τιμή config είναι μια συμβολοσειρά CSS που προστίθεται μετά την οδηγία @import "tailwindcss". Εδώ μπορείτε να χρησιμοποιήσετε οποιαδήποτε έγκυρη σύνταξη Tailwind v4 CSS:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: oklch(0.7 0.15 200); } @layer base { h1 { font-size: var(--text-4xl); } }"
}
}
Για διαμορφώσεις πολλών γραμμών, η προσέγγιση με φίλτρο είναι πιο πρακτική:
add_filter('blockstudio/settings/tailwind/config', function () {
return <<<CSS
@theme {
--color-primary: #3b82f6;
--color-secondary: #10b981;
--font-family-heading: 'Inter', sans-serif;
--breakpoint-xs: 30rem;
}
@layer base {
body {
font-family: var(--font-family-sans);
}
}
@layer utilities {
.btn { @apply px-4 py-2 rounded-lg font-medium; }
.btn-primary { @apply bg-blue-500 text-white hover:bg-blue-600; }
.card { @apply bg-white rounded-xl shadow-lg p-6; }
}
CSS;
});
Προσαρμοσμένες κλάσεις utility
Για να ορίσετε επαναχρησιμοποιήσιμα ψευδώνυμα κλάσεων, χρησιμοποιήστε το @layer utilities με την οδηγία @apply του Tailwind απευθείας στη συμβολοσειρά διαμόρφωσης:
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; } @layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } .section { @apply py-16 px-4 max-w-7xl mx-auto; } }"
}
}
Αυτό μεταγλωττίζει αυτές τις κλάσεις μαζί με όλα τα τυπικά utilities του Tailwind. Λειτουργούν τόσο στο frontend (μεταγλώττιση από την πλευρά του διακομιστή) όσο και στον επεξεργαστή (προεπισκόπηση CDN).
Το Blockstudio διατηρεί την κανονική σειρά επιπέδων cascade του Tailwind:
theme, base, components και μετά utilities. Αυτό αντιστοιχεί στο Tailwind CSS, ώστε
οι κανόνες σε μεταγενέστερα επίπεδα να μπορούν να υπερισχύουν των προηγούμενων, όπως αναμένεται.
Τύπος πεδίου κλάσεων
Για να χρησιμοποιήσετε κλάσεις Tailwind στο πεδίο classes ενός block με υποστήριξη αυτόματης συμπλήρωσης, ορίστε το tailwind: true στο πεδίο:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{
"id": "classes",
"type": "classes",
"label": "Classes",
"tailwind": true,
"default": "bg-white text-gray-900"
}
]
}
}
Όταν το tailwind είναι true:
- Το πεδίο παρέχει προτάσεις αυτόματης συμπλήρωσης από την πλήρη λίστα κλάσεων Tailwind
- Το script CDN Tailwind φορτώνεται στον επεξεργαστή για ζωντανή προεπισκόπηση
- Οι κλάσεις αποθηκεύονται ως συμβολοσειρά με διαχωρισμό διαστημάτων στα γνωρίσματα του block
Χρησιμοποιήστε την τιμή classes στο πρότυπό σας:
<div class="<?php echo $a['classes']; ?>">
<!-- block content -->
</div>
Αναφορά ρυθμίσεων
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean | false |
Ενεργοποίηση μεταγλώττισης Tailwind CSS στο frontend |
config |
string | "" |
Συμβολοσειρά διαμόρφωσης Tailwind v4 με προτεραιότητα στο CSS |
Ρύθμιση μέσω JSON
{
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: pink; }"
}
}
Ρύθμιση μέσω φίλτρων
add_filter('blockstudio/settings/tailwind/enabled', '__return_true');
add_filter('blockstudio/settings/tailwind/config', function () {
return '@theme { --color-brand: pink; }';
});
Προσωρινή αποθήκευση
Το Blockstudio χρησιμοποιεί προσαρμοσμένη στρατηγική προσωρινής αποθήκευσης, σχεδιασμένη για την αρχιτεκτονική utility του Tailwind.
Πώς λειτουργεί η προσωρινή αποθήκευση
Αντί να κατακερματίζει ολόκληρο το HTML της σελίδας (κάτι που θα ακύρωνε την προσωρινή αποθήκευση σε κάθε αίτημα λόγω των nonce, των χρονικών σημάνσεων και άλλου δυναμικού περιεχομένου), το Blockstudio εξάγει μόνο τους υποψήφιους CSS class από το HTML. Αυτοί οι υποψήφιοι ταξινομούνται και κατακερματίζονται μαζί με τη διαμόρφωση CSS, ώστε να παραχθεί ένα σταθερό κλειδί προσωρινής αποθήκευσης.
Αυτό σημαίνει ότι:
- Δύο σελίδες που χρησιμοποιούν το ίδιο σύνολο κλάσεων Tailwind μοιράζονται το ίδιο αποθηκευμένο αρχείο CSS, ακόμα κι αν το HTML τους είναι εντελώς διαφορετικό
- Το δυναμικό περιεχόμενο, όπως nonce, γραμμές χρηστών που έχουν συνδεθεί, αριθμοί σχολίων και χρονικές σημάνσεις, δεν ακυρώνει την προσωρινή αποθήκευση
- Η προσωρινή αποθήκευση ακυρώνεται μόνο όταν αλλάξει το σύνολο κλάσεων CSS μιας σελίδας ή η διαμόρφωση Tailwind
Όταν ένα runtime χρησιμοποιεί μια λογική πηγή ανακάλυψης, η επιλεγμένη πηγή και το περιβάλλον του runtime συμμετέχουν επίσης στον χώρο ονομάτων της προσωρινής αποθήκευσης. Τα τελευταία έγκυρα CSS απομονώνονται μεταξύ των προεπισκοπήσεων και δεν διαρρέουν από τη μία επιλογή πηγής στην άλλη.
Θέση προσωρινής αποθήκευσης
Τα αρχεία προσωρινής αποθήκευσης αποθηκεύονται στο:
wp-content/blockstudio/cache/sites/{network-blog}/{runtime-identity}/tailwind/
Το διαμορφωμένο cache.path, η τρέχουσα ταυτότητα multisite και η πλήρης ταυτότητα runtime καθορίζουν το ακριβές πρόθεμα. Κάθε αρχείο ονομάζεται με ένα hash MD5:
{hash}.css.
Εκκαθάριση προσωρινής αποθήκευσης
Διαγράψτε τα περιεχόμενα του καταλόγου προσωρινής αποθήκευσης για να επιβάλετε νέα μεταγλώττιση:
// Clear all cached Tailwind CSS
Blockstudio\Runtime_Cache::purge('tailwind');
Ή μέσω WP-CLI:
wp eval "Blockstudio\\Runtime_Cache::purge('tailwind');"
Το επόμενο αίτημα στο frontend θα μεταγλωττίσει ξανά και θα αποθηκεύσει αυτόματα το CSS.
Φίλτρα
blockstudio/tailwind/css
Τροποποιήστε την είσοδο CSS πριν από τη μεταγλώττιση. Η συμβολοσειρά εισόδου CSS ξεκινά με @import "tailwindcss"; και ακολουθεί οποιαδήποτε διαμόρφωση. Χρησιμοποιήστε αυτό το φίλτρο για να προσθέσετε επιπλέον οδηγίες CSS, προσαρμοσμένους κανόνες @layer ή εισαγωγές plugin.
add_filter('blockstudio/tailwind/css', function (string $css): string {
// Add a custom utility
$css .= "\n@utility container-narrow { max-width: 48rem; margin-inline: auto; }";
return $css;
});
Η πλήρης είσοδος CSS που μεταγλωττίζεται έχει την εξής μορφή:
/* Base import */
@import 'tailwindcss';
/* Config from settings (if set) */
@theme {
--color-brand: pink;
}
/* Anything added via the blockstudio/tailwind/css filter */
Ενδιάμεση μνήμη εξόδου
Η μεταγλώττιση Tailwind ενσωματώνεται στο σύστημα ενδιάμεσης μνήμης εξόδου του Blockstudio. Η μνήμη καταγράφει το πλήρες HTML της σελίδας αφού ολοκληρωθεί η απόδοσή του από το WordPress, επιτρέποντας στο Tailwind να σαρώσει όλες τις κλάσεις από κάθε πηγή: πρότυπα block, πρότυπα θέματος, έξοδο plugin, φίλτρα the_content και περιοχές widget.
Το φίλτρο μεταγλώττισης εκτελείται με προτεραιότητα 999999 στο hook blockstudio/buffer/output, διασφαλίζοντας ότι επεξεργάζεται το τελικό HTML μετά από όλες τις άλλες τροποποιήσεις. Η ενδιάμεση μνήμη ξεκινά στην ενέργεια template_redirect, οπότε εκτελείται μόνο σε αιτήματα frontend και όχι στο περιβάλλον διαχείρισης, στο REST API ή σε περιβάλλοντα AJAX.
Η αποθήκευση ολόκληρου του εγγράφου στην ενδιάμεση μνήμη καθιστά δυνατή αυτή τη λειτουργία, γι’ αυτό είναι ενεργοποιημένη από προεπιλογή. Ένας ιστότοπος που δεν χρησιμοποιεί ούτε Tailwind ούτε στοιχεία block μπορεί να την απενεργοποιήσει:
add_filter( 'blockstudio/buffer/enabled', '__return_false' );
Η επιστροφή του false παραλείπει εντελώς την ενδιάμεση μνήμη, απενεργοποιώντας επίσης τη μεταγλώττιση Tailwind και τη μεταφορά των στυλ και των script των block στην κεφαλίδα και στο υποσέλιδο.
Αρχιτεκτονική
Frontend Request
│
├─ WordPress renders HTML into output buffer
│
├─ blockstudio/buffer/output filter (priority 999999)
│ │
│ ├─ Settings::get('tailwind/enabled') → false? Return HTML unchanged
│ │
│ ├─ build_css_input()
│ │ ├─ @import "tailwindcss"
│ │ ├─ + tailwind/config setting
│ │ └─ + blockstudio/tailwind/css filter
│ │
│ ├─ TailwindPHP::extractCandidates($html)
│ │ └─ Returns array of CSS class names found in HTML
│ │
│ ├─ Cache key = md5(sorted candidates + css input)
│ │
│ ├─ Cache hit?
│ │ ├─ Yes → Read CSS from the shared runtime `tailwind/{hash}.css` scope
│ │ └─ No → TailwindPHP::generate() → Write to cache file
│ │
│ └─ Inject inline CSS, or link the content-hashed cache file when tailwind.output is "link"
│
└─ Browser receives HTML with compiled CSS
Editor Request
│
├─ Admin loads block editor
│
├─ Block with classes field (tailwind: true) detected
│ └─ Block_Registry::set_tailwind_active(true)
│
├─ Admin passes isTailwindActive + tailwindUrl to JS
│
└─ useTailwind() hook
├─ Injects Tailwind CDN script into document
├─ Creates hidden template div with HTML content
├─ Creates style tag for config
└─ CDN compiles CSS in-browser for live preview
Πλήρες παράδειγμα
Μια πλήρης λειτουργική ρύθμιση με προσαρμοσμένα χρώματα θέματος και ένα block που τα χρησιμοποιεί:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"tailwind": {
"enabled": true,
"config": "@theme { --color-brand: #6366f1; --color-brand-light: #a5b4fc; --color-surface: #f8fafc; } @layer utilities { .section-padding { @apply py-20 px-6; } .content-width { @apply max-w-5xl mx-auto; } .heading-xl { @apply text-4xl font-bold tracking-tight; } }"
}
}
{
"name": "my-theme/hero",
"title": "Hero Section",
"blockstudio": {
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title",
"default": "Welcome"
},
{
"id": "wrapperClasses",
"type": "classes",
"label": "Wrapper Classes",
"tailwind": true,
"default": "section-padding bg-surface"
},
{
"id": "titleClasses",
"type": "classes",
"label": "Title Classes",
"tailwind": true,
"default": "heading-xl text-brand"
}
]
}
}
<section class="<?php echo $a['wrapperClasses']; ?>">
<div class="content-width">
<h1 class="<?php echo $a['titleClasses']; ?>">
<?php echo esc_html($a['title']); ?>
</h1>
</div>
</section>
Αυτό αποδίδεται στο frontend με όλα τα utilities Tailwind και τα προσαρμοσμένα χρώματα θέματος μεταγλωττισμένα σε μία ενσωματωμένη ετικέτα <style>.
Design tokens, προσαρμοσμένα utilities και η πλήρης ρύθμιση Tailwind v4 για θέμα έτοιμο για παραγωγή.