Zum Inhalt springen

Kontext

Wenn Blöcke innerhalb eines Loops verwendet werden (zum Beispiel in einem Query-Block), wird der Block für jede Iteration des Loops einmal ausgeführt. Blockstudio bietet praktische Kurzformen für den Zugriff auf den aktuellen Loop und den äußeren Kontext.

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>

Verfügbare Variablen

In deinen Block-Templates kannst du auf folgende Variablen zugreifen:

Variable Kurzform Beschreibung
$attributes $a Blockattribute
$block $b Blockdaten (Name, Titel, postId, postType, Kontext usw.)
$context $c Kontext des übergeordneten Blocks
$innerBlocks – Inhalt der InnerBlocks

Blockdaten

Die Variable $block / $b enthält:

Eigenschaft Beschreibung
name Blockname (e.g, my-theme/my-block)
title Blocktitel
dir Pfad zum Blockverzeichnis
url URL des Blockverzeichnisses
postId ID des aktuellen Beitrags
postType Typ des aktuellen Beitrags
context Loop-Kontext (innerhalb eines Query-Blocks)

Innerhalb eines Query-Blocks bleibt postId der gerade angezeigte Beitrag, während $post_id und context.postId dem aktuellen Loop-Element folgen. Gibt es keinen abgefragten Beitrag, etwa bei einer REST-Anfrage oder einem WP-CLI, ist postId der Beitrag, für den der Block gerendert wird. Er stammt aus dem postId-Blockkontext oder dem globalen Beitrag.

Übergeordneter Kontext

Bei Verwendung von usesContext greifst du über $context auf die Daten des übergeordneten Blocks zu:

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

Blockstudio übernimmt providesContext automatisch. Du musst usesContext nur zum untergeordneten Block hinzufügen. Du brauchst providesContext nicht manuell in block.json des übergeordneten Blocks zu deklarieren, da Blockstudio es für alle Attribute registriert.

Weitere Informationen findest du unter InnerBlocks-Kontext.

Blockkontext und Kommunikation

Praktische Muster: Kartenraster, Preistabellen und Abschnittscontainer, in denen Blöcke Daten gemeinsam nutzen müssen.