Καταχώριση χαρακτηριστικών
Τα χαρακτηριστικά ορίζονται μέσα στον πίνακα blockstudio.attributes στο αρχείο block.json σας.
Βασικό παράδειγμα
JSON
{
"name": "my-theme/my-block",
"title": "My Block",
"blockstudio": {
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title"
},
{
"id": "content",
"type": "textarea",
"label": "Content"
}
]
}
}
Ιδιότητες χαρακτηριστικών
Όλα τα χαρακτηριστικά έχουν τις ακόλουθες ιδιότητες:
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
id |
string | Μοναδικό αναγνωριστικό του χαρακτηριστικού |
type |
string | Ο τύπος πεδίου (text, textarea, select κ.λπ.) |
label |
string | Ετικέτα που εμφανίζεται στον επεξεργαστή |
default |
mixed | Προεπιλεγμένη τιμή του χαρακτηριστικού |
help |
string | Βοηθητικό κείμενο που εμφανίζεται ως επεξήγηση δίπλα στην ετικέτα |
position |
string | Πού εμφανίζεται το πεδίο: inspector (προεπιλογή) ή toolbar |
conditions |
array | Λογική συνθηκών για την εμφάνιση ή απόκρυψη του πεδίου |
Θέση
Από προεπιλογή, όλα τα πεδία εμφανίζονται στον επιθεωρητή block (πλαϊνή γραμμή). Μπορείτε να το αλλάξετε με την ιδιότητα position:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "alignment",
"type": "select",
"label": "Alignment",
"position": "toolbar",
"options": [
{ "value": "left", "label": "Left" },
{ "value": "center", "label": "Center" },
{ "value": "right", "label": "Right" }
]
}
]
}
}
Προεπιλεγμένες τιμές
Ορίστε προεπιλεγμένες τιμές χρησιμοποιώντας την ιδιότητα default:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title",
"default": "Hello World"
},
{
"id": "showBorder",
"type": "toggle",
"label": "Show Border",
"default": true
}
]
}
}
Βοηθητικό κείμενο
Προσθέστε βοηθητικό κείμενο για να καθοδηγήσετε τους χρήστες:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "apiKey",
"type": "text",
"label": "API Key",
"help": "Enter your API key from the settings page"
}
]
}
}
Πρόσβαση σε χαρακτηριστικά
Στο πρότυπό σας, τα χαρακτηριστικά είναι διαθέσιμα μέσω της σύντομης σύνταξης $a (ή $attributes):
PHP
<h1><?php echo $a['title']; ?></h1>
<p><?php echo $a['content']; ?></p>
Ή στο Twig:
Twig
<h1>{{ a.title }}</h1>
<p>{{ a.content }}</p>