InnerBlocks
Τα εσωτερικά blocks σάς επιτρέπουν να εισάγετε επιπλέον blocks στα δικά σας. Στο παρασκήνιο, το Blockstudio χρησιμοποιεί το στοιχείο InnerBlocks. Σημειώστε ότι είναι δυνατή η χρήση μόνο ενός στοιχείου InnerBlocks ανά block· αυτός είναι περιορισμός του WordPress.
Βασική χρήση
Για να χρησιμοποιήσετε το InnerBlocks, προσθέστε το στοιχείο <InnerBlocks /> στο πρότυπο του block σας:
<InnerBlocks />
Η σύνθεση εξαρτάται από εσάς. Μπορείτε να ενθέσετε το στοιχείο InnerBlocks σε όσα επίπεδα θέλετε ή να το χρησιμοποιήσετε μόνο του.
Ιδιότητες
allowedBlocks
Το prop allowedBlocks σάς επιτρέπει να ορίσετε ποια blocks μπορούν να εισαχθούν στο στοιχείο InnerBlocks.
PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />
Twig
<InnerBlocks allowedBlocks="{{ ['core/heading', 'core/paragraph']|json_encode|escape('html_attr') }}" />
Το allowedBlocks δέχεται επίσης tokens που επεκτείνονται από τον διακομιστή. Τα tokens επεκτείνονται πριν ο επεξεργαστής λάβει το πρότυπο, ενώ τα κυριολεκτικά ονόματα block παραμένουν αμετάβλητα.
| Token | Περιγραφή |
|---|---|
namespace/* |
Κάθε εγγεγραμμένο block σε αυτόν τον χώρο ονομάτων |
category:<slug> |
Κάθε εγγεγραμμένο block σε αυτήν την κατηγορία block WordPress |
@theme |
Κάθε block Blockstudio που είναι εγγεγραμμένο από το ενεργό θέμα |
Οι επεκταμένες καταχωρίσεις αποδιπλοποιούνται με τη σειρά του δημιουργού:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Τα tokens που δεν αντιστοιχούν σε κανένα block παραλείπονται. Η έξοδος του frontend παραμένει αμετάβλητη, επειδή το allowedBlocks χρησιμοποιείται μόνο από τον επεξεργαστή.
ετικέτα
Από προεπιλογή, το στοιχείο InnerBlocks αποδίδεται ως στοιχείο div. Μπορείτε να το αλλάξετε χρησιμοποιώντας το prop tag.
<InnerBlocks tag="section" />
πρότυπο
Το prop template σάς επιτρέπει να ορίσετε ένα πρότυπο για το στοιχείο InnerBlocks.
PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
['core/heading', ['placeholder' => 'Book Title']],
['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />
Twig
<InnerBlocks template="{{ [
['core/heading', { placeholder: 'Book Title' }],
['core/paragraph', { placeholder: 'Summary' }]
]|json_encode|escape('html_attr') }}" />
templateLock
Το prop templateLock σάς επιτρέπει να ορίσετε αν το πρότυπο μπορεί να τροποποιηθεί ή όχι.
| Τιμή | Περιγραφή |
|---|---|
contentOnly |
Αποτρέπει όλες τις λειτουργίες. Οι τύποι block χωρίς περιεχόμενο αποκρύπτονται από την προβολή λίστας. Δεν μπορεί να παρακαμφθεί από θυγατρικά στοιχεία. |
all |
Αποτρέπει όλες τις λειτουργίες. Δεν είναι δυνατή η εισαγωγή, μετακίνηση ή διαγραφή blocks. |
insert |
Αποτρέπει την εισαγωγή ή αφαίρεση blocks, αλλά επιτρέπει τη μετακίνηση υπαρχόντων. |
false |
Αποτρέπει την εφαρμογή κλειδώματος, ακόμη κι αν ένα γονικό block περιλαμβάνει κλείδωμα. |
renderAppender
Το prop renderAppender σάς επιτρέπει να ορίσετε τον τύπο προσθήκης block.
| Τιμή | Περιγραφή |
|---|---|
default |
Εμφάνιση του προεπιλεγμένου προσαρτήματος μπλοκ (προσάρτημα σε στυλ παραγράφου όταν επιτρέπεται μπλοκ παραγράφου) |
button |
Εμφάνιση κουμπιού με εικονίδιο + ως προσάρτημα |
useBlockProps
Το useBlockProps αφαιρεί το εξωτερικό περίβλημα του στοιχείου InnerBlocks
μέσα στον επεξεργαστή. Δείτε το useBlockProps για περισσότερες πληροφορίες.
Περιεχόμενο
Καταχώριση
Το Blockstudio υποστηρίζει περιεχόμενο για το στοιχείο InnerBlocks. Αυτό σας επιτρέπει να
περνάτε δεδομένα από το γονικό μπλοκ στα θυγατρικά μπλοκ. Παρότι χρησιμοποιεί τον
βασικό μηχανισμό context του WordPress στο παρασκήνιο, το Blockstudio προσφέρει πιο εύχρηστο API.
Αντί να ορίζετε ξεχωριστά όλα τα γνωρίσματα που πρέπει να μεταβιβαστούν μέσω του περιεχομένου, μπορείτε απλώς να εγγραφείτε σε όλα τα γνωρίσματα ενός γονικού μπλοκ.
Κάθε θυγατρικό μπλοκ λαμβάνει τις τιμές του δικού του γονικού μπλοκ, ακόμη και κατά την πρώτη προφορτωμένη απόδοση στον επεξεργαστή. Όταν ενημερώνονται τα πεδία ενός παρόχου, ενημερώνονται και τα θυγατρικά του στον επεξεργαστή, ακόμη κι αν η προηγούμενη απόδοση δεν έχει ολοκληρωθεί. Τα ίδια θυγατρικά μπλοκ κάτω από διαφορετικούς παρόχους διατηρούν ξεχωριστές αποθηκευμένες αποδόσεις που λαμβάνουν υπόψη το περιεχόμενο.
Ας υποθέσουμε ότι έχετε ρυθμίσει ένα μπλοκ-περιέκτη ως εξής:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/container",
"title": "Container",
"category": "design",
"icon": "star-filled",
"description": "Container block.",
"blockstudio": {
"attributes": [
{
"id": "full-width",
"type": "toggle",
"label": "Makes section full width"
}
]
}
}
Μέσα στο θυγατρικό μπλοκ, χρησιμοποιήστε απλώς την ιδιότητα usesContext με το όνομα του γονικού
μπλοκ, για να αποκτήσετε πρόσβαση σε όλα τα γνωρίσματα του γονικού μπλοκ στο πρότυπο του μπλοκ σας.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/element",
"title": "Element",
"category": "design",
"icon": "star-filled",
"description": "Element block.",
"usesContext": ["blockstudio/container"],
"parent": ["blockstudio/container"],
"blockstudio": true
}
Πρότυπα
Οι μεταβλητές $context και $c είναι διαθέσιμες μέσα στα πρότυπα των μπλοκ σας,
για πρόσβαση σε όλα τα γνωρίσματα του γονικού μπλοκ. Τα θυγατρικά μπλοκ επαναφορτώνονται
αυτόματα στον επεξεργαστή όταν αλλάζουν τα δεδομένα του γονικού μπλοκ.
PHP
<?php $container = $context['blockstudio/container']; ?>
<h1>
<?php echo $container['full-width']
? 'is full width'
: 'no full width'; ?>
</h1>
Twig
{% set container = context['blockstudio/container'] %}
<h1>
{{ container['full-width']
? 'is full width'
: 'no full width' }}
</h1>
Περίβλημα στο frontend
Το InnerBlocks πρέπει να αποδίδει ένα στοιχείο-περίβλημα γύρω από τα θυγατρικά στοιχεία μέσα
στον επεξεργαστή. Ωστόσο, μπορείτε να το αφαιρέσετε από το frontend χρησιμοποιώντας το φίλτρο
blockstudio/blocks/components/inner_blocks/frontend/wrap.
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
return false; // Remove wrapper
}, 10, 2);
Πρόωρη επιστροφή
Αν θέλετε να επιστρέψετε πρόωρα από τη μέθοδο render του μπλοκ σας, μπορείτε να
ελέγξετε αν η μεταβλητή $innerBlocks είναι κενή. Αυτό είναι χρήσιμο όταν δεν θέλετε
να αποδώσετε τίποτα αν δεν υπάρχουν εσωτερικά μπλοκ.
<?php if (strip_tags($innerBlocks) === '') {
return;
} ?>
<InnerBlocks tag="section" />
Επειδή το <InnerBlocks/> αποδίδει πάντα μια κενή ετικέτα παραγράφου, μπορείτε να χρησιμοποιήσετε
τη συνάρτηση strip_tags για να ελέγξετε αν το περιεχόμενο είναι κενό.
Δυναμικά πρότυπα
Οι τύποι πεδίων Select και
Radio υποστηρίζουν τη δυναμική δημιουργία του προτύπου InnerBlocks
ανάλογα με την τιμή του πεδίου. Αυτό είναι χρήσιμο αν θέλετε να επιτρέψετε στον χρήστη να επιλέξει διαφορετικό πρότυπο για το στοιχείο InnerBlocks.
Για να το κάνετε, προσθέστε απλώς ένα κλειδί innerBlocks στον πίνακα επιλογών με το πρότυπο:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/dynamic-layout",
"title": "Dynamic Layout",
"blockstudio": {
"attributes": [
{
"id": "layout",
"type": "select",
"label": "Layout",
"options": [
{
"value": "1",
"label": "Two Columns",
"innerBlocks": [
{
"name": "core/columns",
"innerBlocks": [
{
"name": "core/column",
"innerBlocks": [
{
"name": "core/heading",
"attributes": {
"content": "Left Heading",
"level": 1
}
}
]
},
{
"name": "core/column",
"innerBlocks": [
{
"name": "core/heading",
"attributes": {
"content": "Right Heading",
"level": 1
}
}
]
}
]
}
]
},
{
"value": "2",
"label": "Single Column",
"innerBlocks": [
{
"name": "core/heading",
"attributes": {
"content": "Main Heading",
"level": 1
}
},
{
"name": "core/paragraph",
"attributes": {
"content": "Main content goes here."
}
}
]
}
],
"allowNull": "Select a layout"
}
]
}
}
Περιεχόμενο και επικοινωνία μεταξύ μπλοκ
Μάθετε πώς τα γονικά και τα θυγατρικά μπλοκ μοιράζονται δεδομένα μέσω περιεχομένου.