Πεδίο μπλοκ
Ο τύπος πεδίου block σάς επιτρέπει να αναφέρετε ένα άλλο μπλοκ Blockstudio ως χαρακτηριστικό. Τα πεδία του μπλοκ που αναφέρεται αναπτύσσονται ενσωματωμένα, με το ίδιο σύστημα idStructure και overrides που χρησιμοποιείται στα προσαρμοσμένα πεδία.
Στα πρότυπα, η τιμή επιστρέφει την αποδοσμένη έξοδο του μπλοκ.
Ορισμός
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Έτσι, τα πεδία του μπλοκ που αναφέρεται αναπτύσσονται ενσωματωμένα. Αν το mytheme/card έχει πεδία heading και content, το μπλοκ υποδοχής αποκτά χαρακτηριστικά card_heading και card_content.
Χρήση σε πρότυπο
Στα πρότυπα, η τιμή του πεδίου επιστρέφει την αποδοσμένη HTML του μπλοκ που αναφέρεται:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Μορφή επιστροφής
Καθορίστε τι επιστρέφει η τιμή του πεδίου μέσω του returnFormat:
| Τιμή | Περιγραφή |
|---|---|
rendered |
(προεπιλογή) Η αποδοσμένη έξοδος HTML του μπλοκ που αναφέρεται |
data |
Ένας συσχετιστικός πίνακας με τις τιμές των χαρακτηριστικών του μπλοκ που αναφέρεται |
both |
Ένα αντικείμενο με rendered (HTML) και data (τιμές χαρακτηριστικών) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Παρακάμψεις
Παρακάμψτε μεμονωμένες ιδιότητες πεδίων από το μπλοκ που αναφέρεται, όπως και στα προσαρμοσμένα πεδία:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Συμβατότητα
Το πεδίο μπλοκ λειτουργεί τόσο με τα συνηθισμένα μπλοκ όσο και με τα μπλοκ στοιχείων. Τα μπλοκ στοιχείων είναι ιδανικά, καθώς έχουν σχεδιαστεί για προγραμματιστική απόδοση.