Μετάβαση στο περιεχόμενο

InnerBlocks

Τα εσωτερικά blocks σάς επιτρέπουν να εισάγετε επιπλέον blocks στα δικά σας. Στο παρασκήνιο, το Blockstudio χρησιμοποιεί το στοιχείο InnerBlocks. Σημειώστε ότι είναι δυνατή η χρήση μόνο ενός στοιχείου InnerBlocks ανά block· αυτός είναι περιορισμός του WordPress.

Βασική χρήση

Για να χρησιμοποιήσετε το InnerBlocks, προσθέστε το στοιχείο <InnerBlocks /> στο πρότυπο του block σας:

PHP
<InnerBlocks />

Η σύνθεση εξαρτάται από εσάς. Μπορείτε να ενθέσετε το στοιχείο InnerBlocks σε όσα επίπεδα θέλετε ή να το χρησιμοποιήσετε μόνο του.

Ιδιότητες

allowedBlocks

Το prop allowedBlocks σάς επιτρέπει να ορίσετε ποια blocks μπορούν να εισαχθούν στο στοιχείο InnerBlocks.

PHP

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />

Twig

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 που είναι εγγεγραμμένο από το ενεργό θέμα

Οι επεκταμένες καταχωρίσεις αποδιπλοποιούνται με τη σειρά του δημιουργού:

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />

Τα tokens που δεν αντιστοιχούν σε κανένα block παραλείπονται. Η έξοδος του frontend παραμένει αμετάβλητη, επειδή το allowedBlocks χρησιμοποιείται μόνο από τον επεξεργαστή.

ετικέτα

Από προεπιλογή, το στοιχείο InnerBlocks αποδίδεται ως στοιχείο div. Μπορείτε να το αλλάξετε χρησιμοποιώντας το prop tag.

PHP
<InnerBlocks tag="section" />

πρότυπο

Το prop template σάς επιτρέπει να ορίσετε ένα πρότυπο για το στοιχείο InnerBlocks.

PHP

PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
  ['core/heading', ['placeholder' => 'Book Title']],
  ['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />

Twig

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.

Αντί να ορίζετε ξεχωριστά όλα τα γνωρίσματα που πρέπει να μεταβιβαστούν μέσω του περιεχομένου, μπορείτε απλώς να εγγραφείτε σε όλα τα γνωρίσματα ενός γονικού μπλοκ.

Κάθε θυγατρικό μπλοκ λαμβάνει τις τιμές του δικού του γονικού μπλοκ, ακόμη και κατά την πρώτη προφορτωμένη απόδοση στον επεξεργαστή. Όταν ενημερώνονται τα πεδία ενός παρόχου, ενημερώνονται και τα θυγατρικά του στον επεξεργαστή, ακόμη κι αν η προηγούμενη απόδοση δεν έχει ολοκληρωθεί. Τα ίδια θυγατρικά μπλοκ κάτω από διαφορετικούς παρόχους διατηρούν ξεχωριστές αποθηκευμένες αποδόσεις που λαμβάνουν υπόψη το περιεχόμενο.

Ας υποθέσουμε ότι έχετε ρυθμίσει ένα μπλοκ-περιέκτη ως εξής:

JSON
{
  "$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 με το όνομα του γονικού μπλοκ, για να αποκτήσετε πρόσβαση σε όλα τα γνωρίσματα του γονικού μπλοκ στο πρότυπο του μπλοκ σας.

JSON
{
  "$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
<?php $container = $context['blockstudio/container']; ?>

<h1>
  <?php echo $container['full-width']
      ? 'is full width'
      : 'no full width'; ?>
</h1>

Twig

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.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
  return false; // Remove wrapper
}, 10, 2);

Πρόωρη επιστροφή

Αν θέλετε να επιστρέψετε πρόωρα από τη μέθοδο render του μπλοκ σας, μπορείτε να ελέγξετε αν η μεταβλητή $innerBlocks είναι κενή. Αυτό είναι χρήσιμο όταν δεν θέλετε να αποδώσετε τίποτα αν δεν υπάρχουν εσωτερικά μπλοκ.

PHP
<?php if (strip_tags($innerBlocks) === '') {
  return;
} ?>
<InnerBlocks tag="section" />

Επειδή το <InnerBlocks/> αποδίδει πάντα μια κενή ετικέτα παραγράφου, μπορείτε να χρησιμοποιήσετε τη συνάρτηση strip_tags για να ελέγξετε αν το περιεχόμενο είναι κενό.

Δυναμικά πρότυπα

Οι τύποι πεδίων Select και Radio υποστηρίζουν τη δυναμική δημιουργία του προτύπου InnerBlocks ανάλογα με την τιμή του πεδίου. Αυτό είναι χρήσιμο αν θέλετε να επιτρέψετε στον χρήστη να επιλέξει διαφορετικό πρότυπο για το στοιχείο InnerBlocks.

Για να το κάνετε, προσθέστε απλώς ένα κλειδί innerBlocks στον πίνακα επιλογών με το πρότυπο:

JSON
{
  "$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"
      }
    ]
  }
}

Περιεχόμενο και επικοινωνία μεταξύ μπλοκ

Μάθετε πώς τα γονικά και τα θυγατρικά μπλοκ μοιράζονται δεδομένα μέσω περιεχομένου.