İçeriğe geç

Bağlam

Bloklar bir döngü içinde (örneğin bir Sorgu bloğunda) kullanıldığında, blok döngünün her yinelemesinde bir kez çalıştırılır. Blockstudio, geçerli döngüye ve dış bağlama erişmek için kullanışlı kısayollar sağlar.

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>

Kullanılabilir değişkenler

Blok şablonlarınızda şu değişkenlere erişebilirsiniz:

Değişken Kısa ad Açıklama
$attributes $a Blok öznitelikleri
$block $b Blok verileri (ad, başlık, postId, postType, bağlam vb.)
$context $c Üst blok bağlamı
$innerBlocks – İç blokların içeriği

Blok verileri

$block / $b değişkeni şunları içerir:

Özellik Açıklama
name Blok adı (e.g., my-theme/my-block)
title Blok başlığı
dir Blok dizin yolu
url Blok dizini URL
postId Geçerli gönderi kimliği
postType Geçerli gönderi türü
context Döngü bağlamı (Sorgu bloğunun içindeyken)

Sorgu bloğunun içinde postId görüntülenen gönderi olarak kalırken $post_id ve context.postId geçerli döngü öğesini izler. Sorgulanmış bir gönderi olmadığında, örneğin bir REST isteğinde veya WP-CLI içinde, postId bloğun oluşturulduğu gönderidir; postId blok bağlamından veya genel gönderiden alınır.

Üst bağlam

usesContext kullanırken üst blok verilerine $context üzerinden erişin:

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

Blockstudio, providesContext işlemini otomatik olarak halleder. Alt bloğa yalnızca usesContext eklemeniz gerekir. Blockstudio tüm öznitelikler için kaydettiğinden, üst bloğun block.json bölümünde providesContext öğesini elle tanımlamanız gerekmez.

Daha fazla bilgi için İçBloklar Bağlamı bölümüne bakın.

Blok Bağlamı ve İletişim

Uygulamalı örüntüler: blokların veri paylaşması gereken kart ızgaraları, fiyatlandırma tabloları ve bölüm kapsayıcıları.