Στοιχεία πεδίου κώδικα
Εκτός από τα στατικά στυλ και σενάρια ως αρχεία, το Blockstudio υποστηρίζει επίσης δυναμικά blocks στοιχείων μέσω του πεδίου κώδικα. Ανάλογα με την περίπτωση χρήσης σας, μπορείτε να τα περιορίσετε στο block.
Βασική χρήση
Στην απλούστερη περίπτωση, μπορείτε να αποδώσετε χειροκίνητα το περιεχόμενο του πεδίου κώδικα στο πρότυπό σας.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Επιλογέας περιορισμένης εμβέλειας
Για να αποφύγετε συγκρούσεις με άλλα blocks, μπορείτε να χρησιμοποιήσετε τη μεταβλητή %selector% μέσα στο πεδίο κώδικα μαζί με το useBlockProps στο πρότυπο απόδοσης.
Στα πεδία κώδικα, το %selector% στοχεύει τη συγκεκριμένη εμφάνιση block. Στα αρχεία CSS και SCSS, το %selector% στοχεύει αντίθετα την κοινόχρηστη κλάση περιορισμένης εμβέλειας του block.
Παράδειγμα
Ας υποθέσουμε ότι θέλουμε να στοχεύσουμε την ετικέτα h1 από το παραπάνω παράδειγμα στο πεδίο κώδικά μας.
%selector% h1 {
color: red;
}
Τώρα, το Blockstudio θα κάνει τρία πράγματα:
- Θα δημιουργήσει ένα μοναδικό αναγνωριστικό για τη συγκεκριμένη εμφάνιση block
- Θα αντικαταστήσει το
%selector%με το μοναδικό αναγνωριστικό - Θα προσθέσει τον ίδιο επιλογέα στο στοιχείο με την ένδειξη
useBlockProps
Το τελικό αποτέλεσμα θα μοιάζει κάπως έτσι:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Αυτόματη απόδοση
Η χειροκίνητη απόδοση της ετικέτας style κάθε φορά μπορεί να είναι κουραστική. Για να απλοποιήσετε αυτή τη διαδικασία, μπορείτε να χρησιμοποιήσετε το χαρακτηριστικό asset μέσα στο πεδίο κώδικα.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Έτσι θα δημιουργούνται αυτόματα ετικέτες style για μπλοκ κώδικα με σήμανση css και θα μεταφέρονται στην κεφαλίδα του εγγράφου. Για πεδία με σήμανση javascript ως γλώσσα, θα δημιουργούνται ετικέτες script και θα τοποθετούνται στο τέλος του body.
Στις επεκτάσεις
Όταν χρησιμοποιείτε πεδία κώδικα μέσα σε επεκτάσεις, το χαρακτηριστικό asset δεν είναι απαραίτητο. Το Blockstudio θα αποδίδει αυτόματα το περιεχόμενο του πεδίου κώδικα ως στοιχείο asset, αν η γλώσσα είναι css ή javascript.
Παράδειγμα
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Δεν απαιτείται πρόσθετη ρύθμιση. Τα παραπάνω θα εμφανίζουν ένα πεδίο κώδικα για κάθε μπλοκ core/* στην πλαϊνή γραμμή και θα αποδίδουν αυτόματα το περιεχόμενό του ως asset στη σελίδα.
SCSS
Τα πεδία κώδικα υποστηρίζουν μεταγλώττιση SCSS. Ορίστε τη γλώσσα σε scss και το Blockstudio θα μεταγλωττίσει την τιμή μέσω του ScssPhp πριν την αποδώσει ως CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Λειτουργίες του SCSS όπως μεταβλητές, ένθεση και mixins λειτουργούν κανονικά:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Στον επεξεργαστή, το SCSS μεταγλωττίζεται σε πραγματικό χρόνο από την πλευρά του διακομιστή, ώστε να βλέπετε το αποτέλεσμα καθώς πληκτρολογείτε. Στο frontend, η μεταγλώττιση γίνεται κατά την απόδοση του μπλοκ.