# أضف حقولًا إلى أي كتلة

JSON خالص. بلا قوالب أو دوال عرض.

## حقول مخصصة، بلا قوالب

أنشئ ملف JSON، واستهدف كتلة باستخدام `name`، ثم عرّف الحقول. يربط `set` القيم بالفئات أو الأنماط أو سمات البيانات أو أي سمة HTML أخرى.

يطبّق Blockstudio المخرجات باستخدام معالج الوسوم WordPress HTML. بلا قوالب أو دوال عرض.

[أساسيات الإضافات](https://blockstudio.dev/ar/docs/extensions/)

extend-animation.json

```
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "allowNull": "None",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ],
        "set": [{
          "attribute": "class",
          "value": "animate-{attributes.animation}"
        }]
      }
    ]
  }
}
```

## استهدف أي كتلة

وسّع كتلة أو قائمة أو جميع عناصر مساحة أسماء باستخدام حرف البدل.

## خاصية set

اربط الحقول بالفئات أو الأنماط أو سمات البيانات أو أي سمة HTML.

## حقول شرطية

أظهر الحقول بحسب قيم أخرى باستخدام منطق مماثل للكتل.

## مجموعة الميزات الكاملة

كل أنواع الحقول والمنطق الشرطي والمصادر والخصائص.

## موضع أداة الفحص

ضع الحقول في علامات تبويب الإعدادات أو الأنماط أو الخيارات المتقدمة.

## ترتيب الأولوية

رتّب الإضافات المتعددة التي تستهدف الكتلة نفسها.

## بلا دوال عرض

يطبّق معالج الوسوم HTML المخرجات تلقائيًا.

## JSON Schema

إكمال تلقائي وتحقق مخصصان للمخطط.

## اربط القيم بـ HTML باستخدام set

يربط `set` القيم بالفئات أو الأنماط المضمنة أو سمات البيانات أو أي سمة HTML باستخدام صياغة النقاط، مثل `{attributes.fieldId}`.

يمكنك الوصول إلى قيم الكائنات المتداخلة، أو تطبيقها بشروط، أو إخراج حقل واحد إلى سمات متعددة.

يطبّق الحقل الذي يعيد عدة قيم `set` على كل قيمة منها. تتراكم الفئات والأنماط؛ أما أي سمة أخرى، فيكتب `"join": true` فيها كل القيم مفصولة بمسافات بدلًا من الاحتفاظ بالقيمة الأخيرة.

[خاصية set](https://blockstudio.dev/ar/docs/extensions/#attributes)

extend-color.json

```
{
  "name": "core/heading",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "returnFormat": "both",
        "options": [
          { "value": "#f00", "label": "Red" },
          { "value": "#00f", "label": "Blue" }
        ],
        "set": [
          { "attribute": "style", "value": "color: {attributes.customColor.value}" },
          { "attribute": "data-color", "value": "{attributes.customColor.label}" },
          { "attribute": "class", "value": "has-custom-color" }
        ]
      }
    ]
  }
}
```

## استهدف كتلة واحدة أو آلاف الكتل

استهدف اسمًا واحدًا مثل `"core/paragraph"`، أو مصفوفة من الأسماء، أو مساحة أسماء كاملة باستخدام `"core/*"`.

يمكن لإضافات JSON متعددة استهداف الكتلة نفسها. وتحدد الأولوية ترتيبها في أداة الفحص.

تتخطى قائمة `exclude` في المستوى الأعلى الكتل التي سيطابقها `name`، باستخدام المطابقة الدقيقة ومطابقة أحرف البدل نفسيهما. لا تحصل الكتلة المستبعدة على الحقول ولا على مخرجاتها.

[استهداف الكتل](https://blockstudio.dev/ar/docs/extensions/)

extend-animation.json

```
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ]
      }
    ]
  }
}
```

## استبعاد الكتل

تخطَّ كتلًا مفردة أو بادئات كاملة كانت مطابقة أحرف البدل ستشملها.

## ضم القيم

اكتب كل قيمة محددة لحقل متعدد القيم في سمة واحدة.

## حقل السمات

يكتب حقل السمات أزواج الأسماء والقيم على الكتلة دون قاعدة تعيين.

## الفحص من PHP

يعيد bs_block_extension_fields() الحقول التي تضيفها كل إضافة مطابقة إلى الكتلة، بما في ذلك كتل النواة والكتل التابعة لجهات خارجية.

Plus

## حزمة الإضافات الرسمية

قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.

- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص

[احصل على Plus](https://blockstudio.dev/ar/plus/)
