Kontext
Když se bloky používají uvnitř smyčky (například bloku Query), blok se spustí při každé iteraci smyčky. Blockstudio nabízí užitečné zkratky pro přístup k aktuálnímu kontextu smyčky a nadřazeným kontextům.
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>
Dostupné proměnné
V šablonách bloků máte přístup k těmto proměnným:
| Proměnná | Zkratka | Popis |
|---|---|---|
$attributes |
$a |
Atributy bloku |
$block |
$b |
Data bloku (název, titulek, postId, postType, context atd.) |
$context |
$c |
Kontext nadřazeného bloku |
$innerBlocks |
– | Obsah InnerBlocks |
Data bloku
Proměnná $block / $b obsahuje:
| Vlastnost | Popis |
|---|---|
name |
Název bloku (e.g, my-theme/my-block) |
title |
Titulek bloku |
dir |
Cesta k adresáři bloku |
url |
URL adresáře bloku |
postId |
ID aktuálního příspěvku |
postType |
Typ aktuálního příspěvku |
context |
Kontext smyčky (uvnitř bloku Query) |
Uvnitř bloku Query zůstává postId příspěvkem, který si právě prohlížíte, zatímco $post_id a context.postId se řídí aktuální položkou cyklu. Pokud není dotazován žádný příspěvek, například při požadavku REST nebo WP-CLI, je postId příspěvkem, pro který se blok vykresluje; přebírá se z kontextu bloku postId nebo z globální proměnné příspěvku.
Kontext nadřazeného bloku
Při použití usesContext získáte data nadřazeného bloku přes $context:
<?php
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>
Blockstudio zpracovává providesContext automaticky. Stačí přidat usesContext do podřízeného bloku. Není třeba ručně deklarovat providesContext v block.json nadřazeného bloku, protože Blockstudio jej registruje pro všechny atributy.
Další podrobnosti najdete v části Kontext InnerBlocks.
Praktické vzory: mřížky karet, tabulky cen a obalové sekce, v nichž bloky potřebují sdílet data.