السياق
عند استخدام الكتل داخل حلقة (مثل كتلة Query)، تُنفّذ الكتلة مرة لكل تكرار في الحلقة. يوفر Blockstudio اختصارات مفيدة للوصول إلى سياق الحلقة الحالية والسياق الخارجي.
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>
المتغيرات المتاحة
تتوفر لك هذه المتغيرات داخل قوالب الكتل:
| المتغير | الاسم المختصر | الوصف |
|---|---|---|
$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
$parent = $context['parent-block/name'];
echo $parent['someAttribute'];
?>
يتولى Blockstudio معالجة providesContext تلقائيًا. ما عليك سوى إضافة usesContext إلى الكتلة الفرعية. ولا حاجة إلى تعريف providesContext يدويًا في block.json للكتلة الأم، إذ يسجله Blockstudio لجميع السمات.
راجع سياق InnerBlocks لمزيد من التفاصيل.
أنماط عملية: شبكات البطاقات وجداول الأسعار وأغلفة الأقسام التي تحتاج فيها الكتل إلى مشاركة البيانات.