Pular para o conteúdo

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

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>

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