حقل الكتلة
يتيح لك نوع الحقل block الإشارة إلى كتلة Blockstudio أخرى كسمة. وتُوسّع حقول الكتلة المشار إليها ضمنيًا باستخدام نظام idStructure وoverrides نفسه المستخدم في الحقول المخصصة. وفي القوالب، تُرجع القيمة مخرجات الكتلة المعروضة.
التعريف
JSON
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
يؤدي هذا إلى توسيع حقول الكتلة المشار إليها ضمنيًا. إذا احتوت mytheme/card على حقلي heading وcontent، فستحصل الكتلة المضيفة على سمتي card_heading وcard_content.
الاستخدام في القوالب
في القوالب، تُرجع قيمة الحقل مخرجات HTML المعروضة للكتلة المشار إليها:
Twig
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
PHP
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
صيغة الإرجاع
تحكم في القيمة التي يُرجعها الحقل باستخدام returnFormat:
| القيمة | الوصف |
|---|---|
rendered |
(الافتراضي) مخرجات HTML المعروضة للكتلة المشار إليها |
data |
مصفوفة ترابطية لقيم سمات الكتلة المشار إليها |
both |
كائن يحتوي على rendered (HTML) وdata (قيم السمات) |
JSON
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
التجاوزات
تجاوز خصائص الحقول الفردية للكتلة المشار إليها، كما تفعل مع الحقول المخصصة:
JSON
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
يعمل مع
يعمل حقل الكتلة مع الكتل العادية وكتل المكونات. وتناسب كتل المكونات هذا الاستخدام بطبيعتها، لأنها مصممة للعرض البرمجي.