انتقل إلى المحتوى

السياق

عند استخدام الكتل داخل حلقة (مثل كتلة Query)، تُنفّذ الكتلة مرة لكل تكرار في الحلقة. يوفر Blockstudio اختصارات مفيدة للوصول إلى سياق الحلقة الحالية والسياق الخارجي.

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>

المتغيرات المتاحة

تتوفر لك هذه المتغيرات داخل قوالب الكتل:

المتغير الاسم المختصر الوصف
$attributes $a سمات الكتلة
$block $b بيانات الكتلة (الاسم والعنوان وpostId وpostType والسياق، وغير ذلك)
$context $c سياق الكتلة الأم
$innerBlocks – محتوى InnerBlocks

بيانات الكتلة

يحتوي المتغير $block / $b على:

الخاصية الوصف
name اسم الكتلة (e.g، my-theme/my-block)
title عنوان الكتلة
dir مسار دليل الكتلة
url URL دليل الكتلة
postId معرّف المنشور الحالي
postType نوع المنشور الحالي
context سياق الحلقة (عند الوجود داخل كتلة Query)

داخل كتلة Query، يظل postId هو المقالة التي تتم مشاهدتها، بينما يتبع $post_id وcontext.postId عنصر الحلقة الحالي. عندما لا توجد مقالة مستعلم عنها، مثلًا في طلب REST أو WP-CLI، يكون postId هو المقالة التي تُعرض الكتلة من أجلها، ويُؤخذ من سياق الكتلة postId أو من المقالة العامة.

سياق الكتلة الأم

عند استخدام usesContext، يمكنك الوصول إلى بيانات الكتلة الأم عبر $context:

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

يتولى Blockstudio معالجة providesContext تلقائيًا. ما عليك سوى إضافة usesContext إلى الكتلة الفرعية. ولا حاجة إلى تعريف providesContext يدويًا في block.json للكتلة الأم، إذ يسجله Blockstudio لجميع السمات.

راجع سياق InnerBlocks لمزيد من التفاصيل.

سياق الكتل والتواصل بينها

أنماط عملية: شبكات البطاقات وجداول الأسعار وأغلفة الأقسام التي تحتاج فيها الكتل إلى مشاركة البيانات.