Перейти до вмісту

Контекст

Якщо блоки використовуються всередині циклу (наприклад, блока запиту), блок виконується один раз за кожну ітерацію циклу. 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 Дані блока (name, title, postId, postType, context тощо)
$context $c Контекст батьківського блока
$innerBlocks – Вміст InnerBlocks

Дані блока

Змінна $block / $b містить:

Властивість Опис
name Назва блока (e.g, my-theme/my-block)
title Назва блока
dir Шлях до каталогу блока
url URL каталогу блока
postId ID поточного допису
postType Тип поточного допису
context Контекст циклу (всередині блока запиту)

У блоці 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.

Контекст і взаємодія блоків

Практичні шаблони: сітки карток, таблиці цін і обгортки секцій, де блокам потрібно обмінюватися даними.