سمات الكتلة
لا تتيح لك متغيرات $attributes أو $a الوصول إلا إلى البيانات المسجلة في الخاصية blockstudio. للوصول إلى بيانات كتل WordPress القياسية، مثل المحاذاة أو الطباعة، استخدم متغيرات $block أو $b.
العرض
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
تعيين القيم الافتراضية
معرّفات الحقول المحجوزة
يجب ألا تُعرّف السمات التي يملكها WordPress كحقول Blockstudio لها المعرّف الأعلى مستوى نفسه. المعرّفات anchor وclassName وstyle وlock وmetadata محجوزة، وكذلك السمات الداخلية blockstudio و__BLOCKSTUDIO_KEY وblockEditingMode الخاصة بـ Blockstudio.
تحجز الميزات المفعّلة في WordPress أسماء سماتها أيضًا، حسب الاقتضاء: align وbackgroundColor وtextColor وgradient وfontSize وfontFamily وlayout وborderColor وshadow وariaLabel. كما يحجز التصريح الأصلي لأي من هذه السمات اسمها. وهذا يمنع، على سبيل المثال، استبدال قيمة السلسلة النصية align في النواة بكائن خيارات حقل اختيار.
يُتخطى تسجيل الحقول المتعارضة، ويُسجّل ذلك عبر blockstudio/error/logged (وفي سجل التصحيح WordPress عند تفعيله)، مع ذكر الكتلة والحقل. ولا تُسجّل عناصر تحكم المحرر أو معالجات التخزين أو تعريفات العرض الخاصة بها. أعد تسمية الحقل إلى headingAlign، أو ضعه داخل مجموعة مسماة مثل presentation لإنشاء presentation_align. توجد حقول صفوف المكررات داخل صفوفها، ولا تُعد تعارضات على المستوى الأعلى. ويظل حقل align عادي صالحًا عند تعطيل دعم المحاذاة وعدم وجود سمة align أصلية.
عند ترقية كتلة موجودة مع وجود تعارض، أعد تسمية الحقل وانقل أي قيم محفوظة له إلى المعرّف الجديد. لا يعيد Blockstudio تسمية المحتوى المخزّن بصمت ولا يزيل دعم WordPress.
القيم الافتراضية للسمات الأصلية
لتعيين قيمة افتراضية لخصائص WordPress مثل align، أضف مفتاح default داخل المفتاح attributes:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
بيانات الكتلة المتاحة
يحتوي المتغير $block / $b على:
| الخاصية | الوصف |
|---|---|
name |
اسم الكتلة (e.g وmy-theme/my-block) |
title |
عنوان الكتلة |
dir |
مسار مجلد الكتلة |
url |
URL مجلد الكتلة |
align |
قيمة المحاذاة (إذا كان supports.align مفعّلًا) |
className |
فئة CSS المخصصة (إذا كان supports.customClassName مفعّلًا) |
anchor |
مرساة/معرّف HTML (إذا كان supports.anchor مفعّلًا) |
دعم WordPress
فعّل ميزات كتلة WordPress عبر الخاصية supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
راجع وثائق دعم كتل WordPress للاطلاع على جميع الخيارات المتاحة.