Przejdź do treści

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

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>

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
<?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.