コンテキスト
ブロックがループ内(たとえば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コンテキストを参照してください。
実践的なパターン: ブロック間でデータを共有するカードグリッド、料金表、セクションラッパー。