
# المكونات

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

## block.json

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

```json title="block.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 title="index.php"
<bs:my-theme-card title="My Card" description="Card content." />
```

### PHP

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

```php title="template.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()` للمكونات مطلقًا
