Kontekstas
Kai blokai naudojami cikle (pavyzdžiui, užklausos bloke), blokas vykdomas kiekvieno ciklo žingsnio metu. Blockstudio suteikia patogių būdų pasiekti dabartinio ciklo ir išorinį kontekstą.
PHP
<div>
<h1>
This is the data of current
element inside the loop:
<?php echo $block['context']['postId'] ?>
<?php echo $block['context']['postType'] ?>
</h1>
<h1>
This is the data the current post:
<?php echo $block['postId'] ?>
<?php echo $block['postType'] ?>
</h1>
</div>
Twig
<div>
<h1>
This is the data of current
element inside the loop:
{{ block.context.postId }}
{{ block.context.postType }}
</h1>
<h1>
This is the data the current post:
{{ block.postId }}
{{ block.postType }}
</h1>
</div>
Galimi kintamieji
Blokų šablonuose galite pasiekti šiuos kintamuosius:
| Kintamasis | Trumpinys | Aprašymas |
|---|---|---|
$attributes |
$a |
Bloko atributai |
$block |
$b |
Bloko duomenys (pavadinimas, antraštė, postId, postType, kontekstas ir kt.) |
$context |
$c |
Tėvinio bloko kontekstas |
$innerBlocks |
– | Vidinių blokų turinys |
Bloko duomenys
Kintamajame $block / $b yra:
| Savybė | Aprašymas |
|---|---|
name |
Bloko pavadinimas (e.g, my-theme/my-block) |
title |
Bloko antraštė |
dir |
Bloko aplanko kelias |
url |
Bloko aplanko URL |
postId |
Dabartinio įrašo ID |
postType |
Dabartinio įrašo tipas |
context |
Ciklo kontekstas (užklausos bloko viduje) |
Užklausos bloke postId lieka peržiūrimas įrašas, o $post_id ir context.postId nurodo dabartinį ciklo elementą. Kai užklausto įrašo nėra, pavyzdžiui, REST užklausos metu arba WP-CLI, postId yra įrašas, kuriam atvaizduojamas blokas; jis paimamas iš postId bloko konteksto arba visuotinio įrašo.
Tėvinio bloko kontekstas
Kai naudojate usesContext, tėvinio bloko duomenis pasiekite per $context:
<?php
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>
Blockstudio automatiškai pasirūpina providesContext. Pakanka į antrinį bloką įtraukti usesContext. Nereikia rankiniu būdu deklaruoti providesContext tėvinio bloko block.json, nes Blockstudio užregistruoja jį visiems atributams.
Daugiau informacijos rasite skiltyje Vidinių blokų kontekstas.
Blokų kontekstas ir komunikacija
Praktiniai šablonai: kortelių tinkleliai, kainų lentelės ir sekcijų apvalkalai, kai blokams reikia bendrinti duomenis.