Перейти к содержимому

Контекст

Если блоки используются внутри цикла (например, блока Query), блок выполняется для каждой итерации цикла. Blockstudio упрощает доступ к текущему циклу и внешнему контексту.

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>

Доступные переменные

В шаблонах блоков доступны следующие переменные:

Переменная Сокращение Описание
$attributes $a Атрибуты блока
$block $b Данные блока (имя, заголовок, postId, postType, контекст и т. д.)
$context $c Контекст родительского блока
$innerBlocks – Содержимое InnerBlocks

Данные блока

Переменная $block / $b содержит:

Свойство Описание
name Имя блока (e.g., my-theme/my-block)
title Заголовок блока
dir Путь к каталогу блока
url URL каталога блока
postId ID текущей записи
postType Тип текущей записи
context Контекст цикла (внутри блока Query)

Внутри блока Query postId остаётся просматриваемой записью, а $post_id и context.postId следуют за текущим элементом цикла. Если записи, выбранной запросом, нет, например при запросе REST или в WP-CLI, postId указывает на запись, для которой отображается блок; она берётся из контекста блока postId или глобальной записи.

Родительский контекст

При использовании usesContext получайте данные родительского блока через $context:

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

Blockstudio автоматически обрабатывает providesContext. Достаточно добавить usesContext в дочерний блок. Не нужно вручную объявлять providesContext в block.json родительского блока, поскольку Blockstudio регистрирует его для всех атрибутов.

Подробнее см. в разделе Контекст InnerBlocks.

Контекст блока и взаимодействие

Практические примеры: сетки карточек, таблицы цен и обертки разделов, где блокам нужно обмениваться данными.