コンテンツへスキップ

コンテキスト

ブロックがループ内(たとえばQueryブロック内)で使われる場合、ループの反復ごとにブロックが1回実行されます。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を追加するだけで使えます。Blockstudioがすべての属性に対して登録するため、親ブロックのblock.jsonにprovidesContextを手動で宣言する必要はありません。

詳しくはInnerBlocksコンテキストを参照してください。

ブロックのコンテキストと通信

実践的なパターン: ブロック間でデータを共有するカードグリッド、料金表、セクションラッパー。