Χαρακτηριστικά μπλοκ
Οι μεταβλητές $attributes ή $a παρέχουν πρόσβαση μόνο στα δεδομένα που έχουν καταχωριστεί στην ιδιότητα blockstudio. Για πρόσβαση σε τυπικά δεδομένα μπλοκ WordPress, όπως η στοίχιση ή η τυπογραφία, χρησιμοποιήστε τις μεταβλητές $block ή $b.
Απόδοση
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
Ορισμός προεπιλογών
Δεσμευμένα αναγνωριστικά πεδίων
Τα χαρακτηριστικά που ανήκουν στο WordPress δεν πρέπει να δηλώνονται ως πεδία Blockstudio με το ίδιο αναγνωριστικό ανώτατου επιπέδου. Τα anchor, className, style, lock και metadata είναι δεσμευμένα, όπως και τα εσωτερικά χαρακτηριστικά blockstudio, __BLOCKSTUDIO_KEY και blockEditingMode του Blockstudio.
Τα ενεργοποιημένα WordPress δεσμεύουν επίσης τα ονόματα των χαρακτηριστικών τους: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow και ariaLabel, όπου αυτό εφαρμόζεται. Μια εγγενής δήλωση ενός από αυτά τα χαρακτηριστικά δεσμεύει επίσης το αντίστοιχο όνομα. Έτσι αποφεύγεται, για παράδειγμα, η αντικατάσταση της συμβολοσειράς align του core με το αντικείμενο επιλογής ενός πεδίου select.
Τα πεδία που έρχονται σε σύγκρουση παραλείπονται κατά την καταχώριση και καταγράφονται μέσω του blockstudio/error/logged (και στο αρχείο καταγραφής αποσφαλμάτωσης WordPress όταν είναι ενεργό), με αναφορά στο block και στο πεδίο. Τα στοιχεία ελέγχου του επεξεργαστή, οι χειριστές αποθήκευσης και οι ορισμοί απόδοσής τους δεν καταχωρίζονται. Μετονομάστε το πεδίο σε headingAlign ή τοποθετήστε το μέσα σε μια ονομασμένη ομάδα όπως η presentation για να δημιουργήσετε το presentation_align. Τα πεδία γραμμών repeater βρίσκονται μέσα στη γραμμή τους και δεν προκαλούν συγκρούσεις ανώτατου επιπέδου. Ένα συνηθισμένο πεδίο align παραμένει έγκυρο όταν η υποστήριξη στοίχισης είναι απενεργοποιημένη και δεν υπάρχει εγγενές χαρακτηριστικό align.
Κατά την αναβάθμιση ενός υπάρχοντος block με σύγκρουση, μετονομάστε το πεδίο του και μεταφέρετε τυχόν αποθηκευμένες τιμές πεδίων στο νέο ID. Το Blockstudio δεν μετονομάζει σιωπηρά το αποθηκευμένο περιεχόμενο ούτε αφαιρεί την υποστήριξη για WordPress.
Προεπιλεγμένες τιμές εγγενών γνωρισμάτων
Για να ορίσετε προεπιλεγμένη τιμή για ιδιότητες WordPress όπως η align, προσθέστε ένα κλειδί default μέσα στο κλειδί attributes:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
Διαθέσιμα δεδομένα μπλοκ
Η μεταβλητή $block / $b περιέχει:
| Ιδιότητα | Περιγραφή |
|---|---|
name |
Όνομα μπλοκ (e.g., my-theme/my-block) |
title |
Τίτλος μπλοκ |
dir |
Διαδρομή καταλόγου μπλοκ |
url |
URL καταλόγου μπλοκ |
align |
Τιμή στοίχισης (αν είναι ενεργοποιημένη η supports.align) |
className |
Προσαρμοσμένη κλάση CSS (αν είναι ενεργοποιημένη η supports.customClassName) |
anchor |
Άγκυρα/ID HTML (αν είναι ενεργοποιημένο το supports.anchor) |
Υποστηρίξεις WordPress
Ενεργοποιήστε τις δυνατότητες μπλοκ WordPress μέσω της ιδιότητας supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Για όλες τις διαθέσιμες επιλογές, δείτε την τεκμηρίωση υποστηρίξεων μπλοκ WordPress.