Aller au contenu

Contexte

Lorsque des blocs sont utilisés dans une boucle (par exemple, un bloc Query), le bloc est exécuté une fois à chaque itération de la boucle. Blockstudio fournit des raccourcis pratiques pour accéder à la boucle actuelle et au contexte parent.

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>

Variables disponibles

Dans vos modèles de bloc, vous avez accès aux variables suivantes :

Variable Raccourci Description
$attributes $a Attributs du bloc
$block $b Données du bloc (nom, titre, postId, postType, contexte, etc.)
$context $c Contexte du bloc parent
$innerBlocks – Contenu des blocs internes

Données du bloc

La variable $block / $b contient :

Propriété Description
name Nom du bloc (e.g, my-theme/my-block)
title Titre du bloc
dir Chemin du répertoire du bloc
url URL du répertoire du bloc
postId ID de la publication actuelle
postType Type de publication actuel
context Contexte de la boucle (dans un bloc Query)

Dans un bloc Query, postId reste l’article consulté, tandis que $post_id et context.postId suivent l’élément de la boucle actuelle. Lorsqu’il n’y a aucun article interrogé, par exemple dans une requête REST ou un WP-CLI, postId désigne l’article pour lequel le bloc est rendu, déterminé à partir du contexte du bloc postId ou de l’article global.

Contexte parent

Lors de l’utilisation de usesContext, accédez aux données du bloc parent via $context :

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

Blockstudio gère automatiquement providesContext. Il vous suffit d’ajouter usesContext au bloc enfant. Vous n’avez pas besoin de déclarer manuellement providesContext dans le block.json du bloc parent, car Blockstudio l’enregistre pour tous les attributs.

Consultez Contexte InnerBlocks pour plus de détails.

Contexte et communication entre blocs

Modèles pratiques : grilles de cartes, tableaux de tarifs et conteneurs de section où les blocs doivent partager des données.