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

المكونات

المكونات كتل Blockstudio تمر عبر مسار المعالجة الكامل (السمات والقوالب والأصول وRPC وTailwind)، لكنها لا تظهر في أداة إدراج المحرر WordPress. وهي مصممة لإنشاء أجزاء UI قابلة لإعادة الاستخدام، لا تُعرض إلا برمجيًا.

block.json

عيّن الخاصية component إلى true في كائن blockstudio:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "description",
        "type": "textarea",
        "label": "Description"
      }
    ]
  }
}

العرض

يمكن عرض المكونات بطريقتين:

عارض السلاسل النصية

استخدم وسوم <bs:> في قوالب الصفحات أو محتوى المنشورات:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

PHP

استخدم bs_render_block() أو bs_block() في قوالب PHP:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'attributes' => [
    'title' => 'My Card',
    'description' => 'Card content.',
  ],
]);

الميزات المدعومة

تدعم المكونات جميع ميزات Blockstudio:

  • السمات وأنواع الحقول
  • قوالب PHP وTwig وBlade
  • أصول CSS/SCSS (تُحمّل عند عرض المكون)
  • Tailwind CSS
  • وظائف الخادم (RPC)
  • أنماط محددة النطاق

ما لا ينطبق

بما أن المكونات لا تظهر مطلقًا في المحرر:

  • لا تتوفر معاينة محرر الكتل
  • لن يعثر البحث في أداة إدراج الكتل عليها
  • لا يُستدعى registerBlockType() للمكونات مطلقًا