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

Πλαίσιο και επικοινωνία μπλοκ

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

Το WordPress παρέχει γι’ αυτό ένα πλαίσιο μπλοκ API. Ένα γονικό μπλοκ εκθέτει ορισμένα από τα δεδομένα του και τα θυγατρικά μπλοκ εγγράφονται σε αυτά. Όταν αλλάζει το γονικό μπλοκ, τα θυγατρικά ενημερώνονται αυτόματα. Το Blockstudio απλοποιεί σημαντικά τη διαδικασία: δεν χρειάζεται να ρυθμίσετε καθόλου το providesContext. Κάθε μπλοκ Blockstudio παρέχει αυτόματα όλα τα χαρακτηριστικά του ως πλαίσιο. Τα θυγατρικά μπλοκ χρειάζονται μόνο μία γραμμή στο block.json τους για να εγγραφούν.

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

Πώς λειτουργεί το πλαίσιο στο Blockstudio

Στο τυπικό WordPress, πρέπει να αντιστοιχίσετε ρητά κάθε χαρακτηριστικό του γονικού μπλοκ σε ένα κλειδί πλαισίου στο providesContext και έπειτα να προσθέσετε αυτά τα κλειδιά στη λίστα του usesContext του θυγατρικού μπλοκ. Το Blockstudio παραλείπει εντελώς το πρώτο βήμα.

Γονικό μπλοκ: Δεν απαιτείται ρύθμιση. Κάθε μπλοκ Blockstudio παρέχει αυτόματα όλα τα χαρακτηριστικά του με το όνομα του μπλοκ.

Θυγατρικό μπλοκ: Προσθέστε το usesContext με το όνομα του γονικού μπλοκ:

JSON
{
  "usesContext": ["my-theme/parent-block"]
}

Πρότυπο θυγατρικού μπλοκ: Αποκτήστε πρόσβαση στα χαρακτηριστικά του γονικού μπλοκ μέσω του $context (ή της συντομογραφίας $c):

PHP
<?php $parent = $context['my-theme/parent-block']; ?>
<p>Parent says: <?php echo esc_html( $parent['message'] ); ?></p>

Αυτή είναι όλη η ρύθμιση. Δεν χρειάζεται providesContext στο γονικό μπλοκ, αντιστοίχιση χαρακτηριστικών ή κώδικας καταχώρισης. Το θυγατρικό μπλοκ λαμβάνει όλα τα μετασχηματισμένα χαρακτηριστικά του γονικού μπλοκ: τα πεδία πολυμέσων επιλύονται σε δεδομένα συνημμένων, τα πεδία επιλογής τηρούν το returnFormat και οι επαναλήπτες αναπτύσσονται πλήρως.

Δύο είδη πλαισίου

Το Blockstudio παρέχει δύο μεταβλητές πλαισίου στα πρότυπα, οι οποίες εξυπηρετούν διαφορετικούς σκοπούς:

Μεταβλητή Περιέχει Περίπτωση χρήσης
$context / $c Χαρακτηριστικά γονικού μπλοκ (μέσω usesContext) Επικοινωνία μεταξύ στοιχείων
$block['context'] / $b['context'] Δεδομένα βρόχου WordPress (postId, postType) Βρόχοι μπλοκ ερωτημάτων

Το πρώτο είδος επιτρέπει στα μπλοκ να επικοινωνούν με τα γονικά τους. Το δεύτερο χρησιμοποιείται από μπλοκ μέσα σε βρόχο Query που χρειάζεται να γνωρίζουν ποια ανάρτηση αποδίδουν. Αυτός ο οδηγός εστιάζει στο πρώτο είδος.

Υποστήριξη στον επεξεργαστή

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

Περίβλημα ενότητας

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

Γονικό: Ενότητα

JSON
{
  "name": "my-theme/section",
  "title": "Section",
  "category": "design",
  "icon": "align-wide",
  "description": "Section wrapper with theme settings.",
  "blockstudio": {
    "attributes": [
      {
        "id": "theme",
        "type": "select",
        "label": "Theme",
        "default": "light",
        "options": [
          { "value": "light", "label": "Light" },
          { "value": "dark", "label": "Dark" },
          { "value": "accent", "label": "Accent" }
        ]
      },
      {
        "id": "spacing",
        "type": "select",
        "label": "Spacing",
        "default": "md",
        "options": [
          { "value": "sm", "label": "Small" },
          { "value": "md", "label": "Medium" },
          { "value": "lg", "label": "Large" }
        ]
      }
    ]
  }
}
PHP
<?php
$theme_classes = array(
	'light'  => 'bg-white text-gray-900',
	'dark'   => 'bg-gray-900 text-white',
	'accent' => 'bg-indigo-600 text-white',
);
$spacing_classes = array(
	'sm' => 'py-8',
	'md' => 'py-16',
	'lg' => 'py-24',
);
$classes = ( $theme_classes[ $a['theme'] ] ?? '' ) . ' ' . ( $spacing_classes[ $a['spacing'] ] ?? '' );
?>
<div useBlockProps class="<?php echo esc_attr( $classes ); ?>">
  <InnerBlocks
    allowedBlocks='<?php echo esc_attr( wp_json_encode( array( 'my-theme/section-heading', 'my-theme/section-text', 'core/columns', 'core/group' ) ) ); ?>'
  />
</div>

Θυγατρικό: Επικεφαλίδα ενότητας

JSON
{
  "name": "my-theme/section-heading",
  "title": "Section Heading",
  "category": "design",
  "icon": "heading",
  "description": "Heading that adapts to section theme.",
  "usesContext": ["my-theme/section"],
  "parent": ["my-theme/section"],
  "blockstudio": {
    "attributes": [
      { "id": "text", "type": "text", "label": "Heading", "default": "Section Title" },
      {
        "id": "size",
        "type": "select",
        "label": "Size",
        "default": "lg",
        "options": [
          { "value": "sm", "label": "Small" },
          { "value": "lg", "label": "Large" },
          { "value": "xl", "label": "Extra Large" }
        ]
      }
    ]
  }
}
PHP
<?php
$section = $context['my-theme/section'] ?? array();
$theme   = $section['theme'] ?? 'light';

$color_class = match ( $theme ) {
	'light'  => 'text-gray-900',
	'dark'   => 'text-white',
	'accent' => 'text-white',
	default  => 'text-gray-900',
};

$size_class = match ( $a['size'] ) {
	'sm' => 'text-2xl',
	'lg' => 'text-4xl',
	'xl' => 'text-6xl',
	default => 'text-4xl',
};
?>
<h2 useBlockProps class="<?php echo esc_attr( "$color_class $size_class font-bold" ); ?>">
  <?php echo esc_html( $a['text'] ); ?>
</h2>

Τι δείχνει αυτό: Η επικεφαλίδα δεν έχει δικό της πεδίο χρώματος. Διαβάζει την τιμή theme της ενότητας από το πλαίσιο και προσαρμόζεται ανάλογα. Όταν ο χρήστης αλλάζει την ενότητα από «Ανοιχτό» σε «Σκούρο» στον επεξεργαστή, το χρώμα του κειμένου της επικεφαλίδας ενημερώνεται αμέσως.

Η ιδιότητα parent στο block.json του θυγατρικού μπλοκ περιορίζει τα σημεία όπου μπορεί να εισαχθεί. Εμφανίζεται στο εργαλείο εισαγωγής μόνο όταν ο χρήστης βρίσκεται μέσα σε μπλοκ my-theme/section. Αυτή η ρύθμιση είναι προαιρετική, αλλά συνιστάται για μπλοκ που έχουν νόημα μόνο μέσα σε συγκεκριμένο γονικό μπλοκ.

Θυγατρικό: Κείμενο ενότητας

JSON
{
  "name": "my-theme/section-text",
  "title": "Section Text",
  "category": "design",
  "icon": "text",
  "description": "Body text that adapts to section theme.",
  "usesContext": ["my-theme/section"],
  "parent": ["my-theme/section"],
  "blockstudio": {
    "attributes": [
      { "id": "text", "type": "textarea", "label": "Text", "default": "Section body text." }
    ]
  }
}
PHP
<?php
$section = $context['my-theme/section'] ?? array();
$theme   = $section['theme'] ?? 'light';

$color_class = match ( $theme ) {
	'dark', 'accent' => 'text-white/80',
	default          => 'text-gray-600',
};
?>
<p useBlockProps class="<?php echo esc_attr( "$color_class text-lg leading-relaxed" ); ?>">
  <?php echo esc_html( $a['text'] ); ?>
</p>

Τώρα τόσο η επικεφαλίδα όσο και το κείμενο ανταποκρίνονται στο θέμα της ενότητας. Ο χρήστης επιλέγει το θέμα μία φορά στο γονικό μπλοκ και κάθε θυγατρικό μπλοκ προσαρμόζεται.

Πλέγμα καρτών

Ένα γονικό μπλοκ πλέγματος ελέγχει τις ρυθμίσεις διάταξης για τα θυγατρικά μπλοκ καρτών. Το γονικό μπλοκ ορίζει τις στήλες και το διάκενο. Τα θυγατρικά μπλοκ χρησιμοποιούν αυτές τις τιμές για να κατανοούν το πλαίσιο διάταξής τους και να προσαρμόζουν ανάλογα τη μορφοποίησή τους.

Γονικό: Πλέγμα καρτών

JSON
{
  "name": "my-theme/card-grid",
  "title": "Card Grid",
  "category": "design",
  "icon": "grid-view",
  "description": "Responsive card grid with configurable columns.",
  "blockstudio": {
    "attributes": [
      {
        "id": "columns",
        "type": "range",
        "label": "Columns",
        "default": 3,
        "min": 1,
        "max": 4,
        "step": 1
      },
      {
        "id": "gap",
        "type": "select",
        "label": "Gap",
        "default": "md",
        "options": [
          { "value": "sm", "label": "Small" },
          { "value": "md", "label": "Medium" },
          { "value": "lg", "label": "Large" }
        ]
      },
      {
        "id": "cardStyle",
        "type": "select",
        "label": "Card Style",
        "default": "elevated",
        "options": [
          { "value": "elevated", "label": "Elevated (shadow)" },
          { "value": "outlined", "label": "Outlined (border)" },
          { "value": "flat", "label": "Flat (no decoration)" }
        ]
      }
    ]
  }
}
PHP
<?php
$gap_class = match ( $a['gap'] ) {
	'sm' => 'gap-4',
	'md' => 'gap-6',
	'lg' => 'gap-8',
	default => 'gap-6',
};
?>
<div useBlockProps class="grid grid-cols-<?php echo esc_attr( $a['columns'] ); ?> <?php echo esc_attr( $gap_class ); ?>">
  <InnerBlocks
    allowedBlocks='<?php echo esc_attr( wp_json_encode( array( 'my-theme/card' ) ) ); ?>'
    template='<?php echo esc_attr( wp_json_encode( array(
      array( 'my-theme/card', array() ),
      array( 'my-theme/card', array() ),
      array( 'my-theme/card', array() ),
    ) ) ); ?>'
  />
</div>

Θυγατρικό: Κάρτα

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "category": "design",
  "icon": "cover-image",
  "description": "Card that inherits style from its grid parent.",
  "usesContext": ["my-theme/card-grid"],
  "parent": ["my-theme/card-grid"],
  "blockstudio": {
    "attributes": [
      { "id": "image", "type": "files", "label": "Image", "multiple": false },
      { "id": "title", "type": "text", "label": "Title", "default": "Card Title" },
      { "id": "description", "type": "textarea", "label": "Description", "default": "Card description goes here." },
      { "id": "url", "type": "link", "label": "Link" }
    ]
  }
}
PHP
<?php
$grid      = $context['my-theme/card-grid'] ?? array();
$card_style = $grid['cardStyle'] ?? 'elevated';

$style_class = match ( $card_style ) {
	'elevated' => 'bg-white rounded-xl shadow-md',
	'outlined' => 'bg-white rounded-xl border border-gray-200',
	'flat'     => 'bg-gray-50 rounded-xl',
	default    => 'bg-white rounded-xl shadow-md',
};
?>
<div useBlockProps class="<?php echo esc_attr( "$style_class overflow-hidden" ); ?>">
  <?php if ( $a['image'] ) : ?>
    <img
      src="<?php echo esc_url( $a['image']['url'] ); ?>"
      alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
      class="w-full aspect-video object-cover" />
  <?php endif; ?>
  <div class="p-6">
    <h3 class="text-lg font-semibold"><?php echo esc_html( $a['title'] ); ?></h3>
    <p class="mt-2 text-gray-600"><?php echo esc_html( $a['description'] ); ?></p>
    <?php if ( $a['url'] ) : ?>
      <a href="<?php echo esc_url( $a['url']['url'] ); ?>" class="mt-4 inline-block text-indigo-600 font-medium">
        <?php echo esc_html( $a['url']['title'] ?: 'Learn more' ); ?>
      </a>
    <?php endif; ?>
  </div>
</div>

Τι δείχνει αυτό: Η κάρτα δεν έχει δικό της πεδίο στυλ. Διαβάζει το cardStyle από το γονικό πλέγμα. Όταν ο χρήστης αλλάζει το πλέγμα από «Με ανύψωση» σε «Με περίγραμμα», όλες οι κάρτες του πλέγματος ενημερώνονται ταυτόχρονα. Έτσι οι κάρτες διατηρούν οπτική συνέπεια, χωρίς ο χρήστης να χρειάζεται να ενημερώνει καθεμία ξεχωριστά.

Το χαρακτηριστικό template στο <InnerBlocks> προσυμπληρώνει το πλέγμα με τρεις κάρτες, δίνοντας στον χρήστη ένα σημείο εκκίνησης.

Πίνακας τιμολόγησης

Ένα πιο σύνθετο μοτίβο, στο οποίο το γονικό μπλοκ παρέχει κοινή επιχειρηματική λογική (νόμισμα, περίοδος χρέωσης) που χρησιμοποιούν τα θυγατρικά μπλοκ κατά την εμφάνιση των στοιχείων τους. Έτσι αποφεύγεται η αντιγραφή των ίδιων πεδίων σε κάθε βαθμίδα τιμολόγησης.

Γονικό: Πίνακας τιμολόγησης

JSON
{
  "name": "my-theme/pricing-table",
  "title": "Pricing Table",
  "category": "text",
  "icon": "money-alt",
  "description": "Pricing comparison with shared currency and billing settings.",
  "blockstudio": {
    "attributes": [
      {
        "id": "currency",
        "type": "select",
        "label": "Currency",
        "default": "usd",
        "options": [
          { "value": "usd", "label": "USD ($)" },
          { "value": "eur", "label": "EUR (\u20ac)" },
          { "value": "gbp", "label": "GBP (\u00a3)" }
        ]
      },
      {
        "id": "period",
        "type": "select",
        "label": "Billing Period",
        "default": "month",
        "options": [
          { "value": "month", "label": "Monthly" },
          { "value": "year", "label": "Yearly" }
        ]
      }
    ]
  }
}
PHP
<div useBlockProps class="grid grid-cols-3 gap-6 items-start">
  <InnerBlocks
    allowedBlocks='<?php echo esc_attr( wp_json_encode( array( 'my-theme/pricing-tier' ) ) ); ?>'
    template='<?php echo esc_attr( wp_json_encode( array(
      array( 'my-theme/pricing-tier', array( 'name' => 'Starter', 'price' => 9 ) ),
      array( 'my-theme/pricing-tier', array( 'name' => 'Pro', 'price' => 29, 'highlighted' => true ) ),
      array( 'my-theme/pricing-tier', array( 'name' => 'Enterprise', 'price' => 99 ) ),
    ) ) ); ?>'
  />
</div>

Θυγατρικό: Βαθμίδα τιμολόγησης

JSON
{
  "name": "my-theme/pricing-tier",
  "title": "Pricing Tier",
  "category": "text",
  "icon": "tag",
  "description": "Single pricing tier that reads currency from parent.",
  "usesContext": ["my-theme/pricing-table"],
  "parent": ["my-theme/pricing-table"],
  "blockstudio": {
    "attributes": [
      { "id": "name", "type": "text", "label": "Tier Name", "default": "Plan" },
      { "id": "price", "type": "number", "label": "Price", "default": 0 },
      { "id": "highlighted", "type": "toggle", "label": "Highlighted", "default": false },
      {
        "id": "features",
        "type": "repeater",
        "label": "Features",
        "attributes": [
          { "id": "text", "type": "text", "label": "Feature" }
        ]
      }
    ]
  }
}
PHP
<?php
$table    = $context['my-theme/pricing-table'] ?? array();
$currency = $table['currency'] ?? 'usd';
$period   = $table['period'] ?? 'month';

$symbols = array(
	'usd' => '$',
	'eur' => "\u{20AC}",
	'gbp' => "\u{00A3}",
);
$symbol = $symbols[ $currency ] ?? '$';

$period_label = $period === 'year' ? '/year' : '/month';

$border_class = $a['highlighted'] ? 'border-2 border-indigo-600' : 'border border-gray-200';
?>
<div useBlockProps class="<?php echo esc_attr( "rounded-xl p-8 $border_class" ); ?>">
  <h3 class="text-lg font-semibold"><?php echo esc_html( $a['name'] ); ?></h3>
  <div class="mt-4">
    <span class="text-4xl font-bold"><?php echo esc_html( $symbol . $a['price'] ); ?></span>
    <span class="text-gray-500"><?php echo esc_html( $period_label ); ?></span>
  </div>
  <?php if ( ! empty( $a['features'] ) ) : ?>
    <ul class="mt-6 space-y-3">
      <?php foreach ( $a['features'] as $feature ) : ?>
        <li class="flex items-center gap-2">
          <span class="text-indigo-600">&#10003;</span>
          <?php echo esc_html( $feature['text'] ); ?>
        </li>
      <?php endforeach; ?>
    </ul>
  <?php endif; ?>
</div>

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

Πλαίσιο βρόχου ερωτήματος

Υπάρχει ένα ξεχωριστό είδος πλαισίου που παρέχει το WordPress μέσα στους βρόχους μπλοκ Query. Όταν ένα μπλοκ αποδίδεται μέσα σε βρόχο, το $block['context'] (ή το $b['context']) περιέχει τα δεδομένα της ανάρτησης για την τρέχουσα επανάληψη:

PHP
<?php
$loop_post_id   = $block['context']['postId'];
$loop_post_type = $block['context']['postType'];
?>
<article useBlockProps>
  <h2><?php echo esc_html( get_the_title( $loop_post_id ) ); ?></h2>
  <p><?php echo esc_html( get_the_excerpt( $loop_post_id ) ); ?></p>
  <a href="<?php echo esc_url( get_permalink( $loop_post_id ) ); ?>">Read more</a>
</article>

Αυτό διαφέρει από το πλαίσιο γονικού μπλοκ ($context / $c). Το πλαίσιο βρόχου παρέχεται από τον πυρήνα του WordPress και περιέχει μόνο τα postId και postType. Δεν χρειάζεται να χρησιμοποιήσετε το usesContext στο block.json σας γι’ αυτό. Το Blockstudio εγγράφει αυτόματα κάθε μπλοκ στα postId και postType.

Πού είναι χρήσιμο το πλαίσιο βρόχου: Προσαρμοσμένες κάρτες αναρτήσεων μέσα σε μπλοκ Query, μπλοκ που εμφανίζουν μεταδεδομένα ανάρτησης ή οποιοδήποτε μπλοκ χρειάζεται να αποδίδεται διαφορετικά για κάθε ανάρτηση ενός βρόχου.

Μπορείτε επίσης να αποκτήσετε πρόσβαση στα δεδομένα ανάρτησης της εξωτερικής σελίδας, ανεξάρτητα από το πλαίσιο βρόχου:

PHP
$outer_post_id   = $block['postId'];   // always the current page
$loop_post_id    = $block['context']['postId'];  // current loop iteration

Ένθετο πλαίσιο

Το πλαίσιο διατρέχει ολόκληρο το δέντρο μπλοκ, όχι μόνο ένα επίπεδο. Αν το μπλοκ A περιέχει το μπλοκ B, το οποίο περιέχει το μπλοκ C, τότε το C μπορεί να εγγραφεί στο πλαίσιο του A. Αυτό λειτουργεί επειδή το WordPress μεταδίδει το πλαίσιο σε κάθε επίπεδο του InnerBlocks.

Κώδικας
my-theme/section (theme: "dark")
└── core/columns
    └── core/column
        └── my-theme/section-heading (reads section context)

Η επικεφαλίδα δεν χρειάζεται να είναι άμεσο θυγατρικό μπλοκ της ενότητας. Μπορεί να είναι ένθετη μέσα σε βασικά μπλοκ (στήλες, ομάδες κ.λπ.) και να λαμβάνει και πάλι το πλαίσιο της ενότητας. Η εγγραφή μέσω usesContext λειτουργεί σε οποιοδήποτε βάθος.

Πολλαπλά γονικά μπλοκ

Ένα θυγατρικό μπλοκ μπορεί να εγγραφεί σε πολλά γονικά μπλοκ:

JSON
{
  "usesContext": ["my-theme/section", "my-theme/card-grid"]
}
PHP
<?php
$section = $context['my-theme/section'] ?? array();
$grid    = $context['my-theme/card-grid'] ?? array();

$theme     = $section['theme'] ?? 'light';
$cardStyle = $grid['cardStyle'] ?? 'elevated';
?>

Αν δεν βρεθεί ένα γονικό μπλοκ στο δέντρο προγόνων, το κλειδί του θα απουσιάζει από το $context. Χρησιμοποιείτε πάντα τον τελεστή συγχώνευσης με null (??) ή ελέγχετε το isset() όταν διαβάζετε τιμές πλαισίου, σε περίπτωση που το μπλοκ χρησιμοποιείται έξω από το αναμενόμενο γονικό μπλοκ.

Αμυντικός προγραμματισμός

Τα μπλοκ που χρησιμοποιούν πλαίσιο πρέπει πάντα να χειρίζονται την περίπτωση όπου λείπει το γονικό μπλοκ. Ο χρήστης μπορεί να εισαγάγει το μπλοκ έξω από το προβλεπόμενο γονικό μπλοκ ή το γονικό μπλοκ μπορεί να μην έχει ορισμένη τιμή για κάποιο συγκεκριμένο πεδίο.

PHP
<?php
// Always provide defaults
$section = $context['my-theme/section'] ?? array();
$theme   = $section['theme'] ?? 'light';
$spacing = $section['spacing'] ?? 'md';
?>

Αν θέλετε να επιβάλετε την εμφάνιση ενός θυγατρικού μπλοκ μόνο μέσα στο γονικό του, προσθέστε την ιδιότητα parent:

JSON
{
  "parent": ["my-theme/section"]
}

Έτσι το μπλοκ αφαιρείται από το εργαλείο εισαγωγής όταν ο χρήστης δεν βρίσκεται μέσα σε μπλοκ my-theme/section. Χωρίς το parent, το μπλοκ εμφανίζεται παντού και το πρότυπό σας πρέπει να χειρίζεται ομαλά το πλαίσιο που λείπει.

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

Συμβουλές

Το πλαίσιο είναι μόνο για ανάγνωση. Τα θυγατρικά μπλοκ δεν μπορούν να τροποποιήσουν τα χαρακτηριστικά του γονικού μπλοκ μέσω του πλαισίου. Τα δεδομένα ρέουν προς τα κάτω, ποτέ προς τα πάνω. Αν ένα θυγατρικό μπλοκ χρειάζεται να επικοινωνήσει κάτι στο γονικό του, απαιτείται διαφορετική προσέγγιση (όπως κοινή κατάσταση στον διακομιστή μέσω του API Interactivity ή μεταδεδομένα ανάρτησης).

Παρέχονται όλα τα χαρακτηριστικά. Το Blockstudio παρέχει κάθε χαρακτηριστικό του γονικού μπλοκ, όχι μόνο όσα επιλέγετε. Έτσι, το θυγατρικό μπλοκ μπορεί να έχει πρόσβαση σε οποιοδήποτε πεδίο ορίζει το γονικό μπλοκ. Αν το γονικό μπλοκ προσθέσει αργότερα ένα νέο πεδίο, τα θυγατρικά μπλοκ αποκτούν αυτόματα πρόσβαση σε αυτό χωρίς αλλαγή ρυθμίσεων.

Μετασχηματισμένες τιμές. Οι τιμές πλαισίου περνούν από τη διοχέτευση μετασχηματισμού χαρακτηριστικών του Blockstudio. Τα πεδία αρχείων περιέχουν όλα τα δεδομένα συνημμένου (url, alt, width, height), τα πεδία επιλογής τηρούν το returnFormat και οι επαναλήπτες αναπτύσσονται αναδρομικά. Λαμβάνετε την ίδια δομή δεδομένων όπως με το $a στο γονικό πρότυπο.

Αντιδραστικότητα στον επεξεργαστή. Όταν ο χρήστης αλλάζει ένα πεδίο του γονικού μπλοκ στον επεξεργαστή, τα θυγατρικά μπλοκ αποδίδονται ξανά αυτόματα. Αυτό χρησιμοποιεί την ενσωματωμένη διάδοση πλαισίου του WordPress, μαζί με ένα React useEffect που εντοπίζει αλλαγές στο πλαίσιο και ενεργοποιεί την απόδοση του θυγατρικού μπλοκ ξανά στον διακομιστή.

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

Επόμενα βήματα

  • Αναφορά πλαισίου: μεταβλητές προτύπων, πλαίσιο βρόχου και δομή δεδομένων $block.
  • InnerBlocks: το στοιχείο <InnerBlocks />, το allowedBlocks, τα πρότυπα και το φίλτρο περιβλήματος της διεπαφής.
  • Οδηγός Interactivity: για αντιδραστικότητα μεταξύ μπλοκ στην πλευρά του πελάτη (το API Interactivity καλύπτει όσα δεν μπορεί να χειριστεί το πλαίσιο: επικοινωνία από θυγατρικό προς γονικό μπλοκ, κατάσταση μεταξύ μπλοκ και ενημερώσεις που ενεργοποιεί ο χρήστης).