Kontekst
Gdy bloki są używane wewnątrz pętli (na przykład bloku Query), blok jest wykonywany raz dla każdej iteracji pętli. Blockstudio udostępnia przydatne skróty ułatwiające dostęp do bieżącej pętli i kontekstu nadrzędnego.
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>
Dostępne zmienne
W szablonach bloków masz dostęp do następujących zmiennych:
| Zmienna | Skrót | Opis |
|---|---|---|
$attributes |
$a |
Atrybuty bloku |
$block |
$b |
Dane bloku (nazwa, tytuł, postId, postType, kontekst itd.) |
$context |
$c |
Kontekst bloku nadrzędnego |
$innerBlocks |
– | Zawartość InnerBlocks |
Dane bloku
Zmienna $block / $b zawiera:
| Właściwość | Opis |
|---|---|
name |
Nazwa bloku (np. e.g, my-theme/my-block) |
title |
Tytuł bloku |
dir |
Ścieżka katalogu bloku |
url |
URL katalogu bloku |
postId |
ID bieżącego wpisu |
postType |
Typ bieżącego wpisu |
context |
Kontekst pętli (wewnątrz bloku Query) |
W bloku Query postId pozostaje oglądanym wpisem, natomiast $post_id i context.postId odnoszą się do bieżącego elementu pętli. Gdy nie ma odpytywanego wpisu, na przykład w żądaniu REST lub WP-CLI, postId jest wpisem, dla którego renderowany jest blok. Jest on pobierany z kontekstu bloku postId lub globalnego wpisu.
Kontekst nadrzędny
Podczas korzystania z usesContext uzyskuj dostęp do danych bloku nadrzędnego za pomocą $context:
<?php
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>
Blockstudio obsługuje providesContext automatycznie. Wystarczy dodać usesContext do bloku podrzędnego. Nie trzeba ręcznie deklarować providesContext w block.json bloku nadrzędnego, ponieważ Blockstudio rejestruje je dla wszystkich atrybutów.
Więcej szczegółów znajdziesz w sekcji Kontekst InnerBlocks.
Kontekst i komunikacja między blokami
Praktyczne wzorce: siatki kart, tabele cen i kontenery sekcji, w których bloki muszą współdzielić dane.