Pereiti prie turinio

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

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

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
<?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.