Контекст
Если блоки используются внутри цикла (например, блока Query), блок выполняется для каждой итерации цикла. Blockstudio упрощает доступ к текущему циклу и внешнему контексту.
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
<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
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>
Blockstudio автоматически обрабатывает providesContext. Достаточно добавить usesContext в дочерний блок. Не нужно вручную объявлять providesContext в block.json родительского блока, поскольку Blockstudio регистрирует его для всех атрибутов.
Подробнее см. в разделе Контекст InnerBlocks.
Контекст блока и взаимодействие
Практические примеры: сетки карточек, таблицы цен и обертки разделов, где блокам нужно обмениваться данными.