Saltar al contenido

Contexto

Cuando se usan bloques dentro de un bucle (por ejemplo, un bloque de consulta), el bloque se ejecuta una vez por cada iteración. Blockstudio ofrece accesos directos prácticos al bucle actual y al 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>

Variables disponibles

Dentro de las plantillas de bloque, tienes acceso a estas variables:

Variable Forma abreviada Descripción
$attributes $a Atributos del bloque
$block $b Datos del bloque (nombre, título, postId, postType, contexto, etc.)
$context $c Contexto del bloque principal
$innerBlocks – Contenido de InnerBlocks

Datos del bloque

La variable $block / $b contiene:

Propiedad Descripción
name Nombre del bloque (e.g, my-theme/my-block)
title Título del bloque
dir Ruta del directorio del bloque
url URL del directorio del bloque
postId ID de la entrada actual
postType Tipo de entrada actual
context Contexto del bucle (dentro de un bloque de consulta)

Dentro de un bloque Query, postId sigue siendo la entrada que se está viendo, mientras que $post_id y context.postId siguen la entrada actual del bucle. Si no hay una entrada consultada, por ejemplo, en una solicitud REST o en WP-CLI, postId corresponde a la entrada para la que se representa el bloque, tomada del contexto del bloque postId o de la entrada global.

Contexto principal

Al usar usesContext, accede a los datos del bloque principal mediante $context:

PHP
<?php
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>

Blockstudio gestiona providesContext automáticamente. Solo tienes que añadir usesContext al bloque secundario. No es necesario declarar manualmente providesContext en block.json del bloque principal, ya que Blockstudio lo registra para todos los atributos.

Consulta Contexto de InnerBlocks para obtener más detalles.

Contexto y comunicación entre bloques

Patrones prácticos: cuadrículas de tarjetas, tablas de precios y contenedores de sección donde los bloques necesitan compartir datos.