التجاوزات
يتيح Blockstudio إمكانية تجاوز الكتل بمستوى عالٍ من التفصيل. قد يكون ذلك مفيدًا في مكتبات الكتل المشتركة عندما تريد تغيير سلوك كتلة دون إنشاء كتلة جديدة من الصفر.
block.json
للبدء، عيّن اسم الكتلة التي تريد تجاوزها إلى المفتاح name، وعيّن المفتاح override إلى true.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true
}
}
عند تعيين الخاصية override إلى true، تُدمج بيانات block.json الجديدة مع بيانات الكتلة الأصلية. وهذا يعني أنه يمكنك تجاوز أي خاصية في الكتلة الأصلية.
السمات
يمكن تجاوز السمات بواسطة id أو إضافتها. مثلًا، لنفترض أننا نريد تجاوز السمة width لكتلة وإضافة سمة height جديدة.
{
"name": "blockstudio/my-block",
"title": "My overridden block title",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "width",
"type": "number",
"default": 280,
"label": "Override width"
},
{
"id": "height",
"type": "number",
"default": 280,
"label": "New height"
}
]
}
}
عند العثور على سمة لها id نفسه، تُدمج بياناتها مع السمة الأصلية. وتُضاف السمات غير الموجودة إلى الكتلة.
تحذير
عند تجاوز السمات، عليك تقديم
typeالسمة الأصلية، حتى إن ظل كما هو.
البُنى المعقدة
عند تجاوز سمات ذات بُنى معقدة (مثل حقول التكرار والمجموعات وعلامات التبويب)، عليك تقديم بنية السمة كاملة حتى العنصر المراد تجاوزه.
{
"name": "blockstudio/my-block",
"blockstudio": {
"override": true,
"attributes": [
{
"id": "tabs",
"type": "tabs",
"tabs": [
{
"id": "tab1",
"attributes": [
{
"key": "group1",
"type": "group",
"title": "Group",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
},
{
"id": "tab2",
"title": "Override tab",
"attributes": [
{
"id": "group",
"type": "group",
"title": "Group ID",
"attributes": [
{
"id": "text",
"type": "text",
"label": "Override text"
}
]
}
]
}
]
}
]
}
}
الأصول
تُستبدل ملفات الأصول عندما يتطابق اسم الملف. مثلًا، إذا كان الملف style.css موجودًا في الكتلة الأصلية، فسيُستبدل بملف style.css في الكتلة المتجاوزة. وتُضاف إلى الكتلة الملفات التي لا تتطابق أسماؤها مع أسماء ملفات الكتلة الأصلية.
قالب العرض
يمكن تجاوز قوالب العرض بتوفير ملف قالب جديد، بأحد الامتدادات التالية: index.php أو index.twig أو index.blade.php.
كتل Twig
يمكن تجاوز قوالب Twig بمستوى أدق باستخدام ميزة الكتل في Twig.
لنفترض أن لدينا قالب العرض التالي لكتلة صورة افتراضية:
<h1>Images:</h1>
{% for image in a.images %}
<div class="content">
{% block image %}
<img src="{{ image.url }}" class="image" />
{% endblock %}
</div>
{% endfor %}
بدلًا من استبدال القالب بأكمله، يمكننا استخدام ميزة extends في Twig لتجاوز أجزاء محددة من القالب مع الإبقاء على البقية كما هي.
{% extends 'index.twig' %}
{% block image %}
<figure>
<img src="{{ image.url }}" class="image" />
<figcaption>{{ image.caption }}</figcaption>
</figure>
{% endblock %}