Contexto
Quando os blocos são usados dentro de um loop (por exemplo, um bloco Query), o bloco é executado uma vez a cada iteração do loop. Blockstudio oferece atalhos práticos para acessar o loop atual e o contexto externo.
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>
Variáveis disponíveis
Dentro dos templates de bloco, você tem acesso a estas variáveis:
| Variável | Atalho | Descrição |
|---|---|---|
$attributes |
$a |
Atributos do bloco |
$block |
$b |
Dados do bloco (nome, título, postId, postType, contexto etc.) |
$context |
$c |
Contexto do bloco pai |
$innerBlocks |
– | Conteúdo de InnerBlocks |
Dados do bloco
A variável $block / $b contém:
| Propriedade | Descrição |
|---|---|
name |
Nome do bloco (e.g, my-theme/my-block) |
title |
Título do bloco |
dir |
Caminho do diretório do bloco |
url |
URL do diretório do bloco |
postId |
ID do post atual |
postType |
Tipo do post atual |
context |
Contexto do loop (quando está dentro de um bloco Query) |
Dentro de um bloco Query, postId continua sendo a publicação que está sendo visualizada, enquanto $post_id e context.postId acompanham o item atual do loop. Quando não há uma publicação consultada, como em uma solicitação REST ou em WP-CLI, postId corresponde à publicação para a qual o bloco está sendo renderizado, obtida do contexto do bloco postId ou da publicação global.
Contexto do pai
Ao usar usesContext, acesse os dados do bloco pai por meio de $context:
<?php
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>
Blockstudio gerencia providesContext automaticamente. Basta adicionar usesContext ao bloco filho. Não é necessário declarar manualmente providesContext no block.json do bloco pai, pois Blockstudio o registra para todos os atributos.
Consulte Contexto de InnerBlocks para saber mais.
Contexto e comunicação entre blocos
Padrões práticos: grades de cartões, tabelas de preços e contêineres de seção nos quais os blocos precisam compartilhar dados.