Siirry sisältöön

Konteksti

Kun lohkoja käytetään silmukan sisällä (esimerkiksi Query-lohkossa), lohko suoritetaan kerran silmukan jokaista kierrosta kohden. Blockstudio tarjoaa käteviä oikoteitä nykyisen silmukan ja ulomman kontekstin tietoihin.

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>

Käytettävissä olevat muuttujat

Lohkomalleissa voit käyttää seuraavia muuttujia:

Muuttuja Lyhenne Kuvaus
$attributes $a Lohkon attribuutit
$block $b Lohkon tiedot (nimi, otsikko, postId, postType, konteksti jne.)
$context $c Ylälohkon konteksti
$innerBlocks – Sisälohkojen sisältö

Lohkon tiedot

$block / $b-muuttuja sisältää:

Ominaisuus Kuvaus
name Lohkon nimi (e.g., my-theme/my-block)
title Lohkon otsikko
dir Lohkon hakemistopolku
url Lohkon hakemiston URL
postId Nykyisen julkaisun ID
postType Nykyisen julkaisun tyyppi
context Silmukan konteksti (Query-lohkon sisällä)

Query-lohkon sisällä postId pysyy tarkasteltavana olevana julkaisuna, kun taas $post_id ja context.postId seuraavat nykyistä silmukan kohdetta. Jos kyselyn kohteena olevaa julkaisua ei ole, esimerkiksi REST-pyynnössä tai kohteessa WP-CLI, postId on se julkaisu, jota varten lohko renderöidään. Se saadaan postId-lohkon kontekstista tai globaalista julkaisusta.

Ylälohkon konteksti

Kun käytät usesContext-ominaisuutta, voit käyttää ylälohkon tietoja muodossa $context:

PHP
<?php
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>

Blockstudio käsittelee providesContext-arvon automaattisesti. Lisää vain usesContext lapsilohkoon. Ylälohkon block.json-määritykseen ei tarvitse lisätä providesContext-määritystä manuaalisesti, sillä Blockstudio rekisteröi sen kaikille attribuuteille.

Katso lisätietoja kohdasta InnerBlocks-konteksti.

Lohkon konteksti ja viestintä

Käytännön malleja: korttiruudukot, hinnoittelutaulukot ja osioiden kääreet, joissa lohkojen on jaettava tietoja.