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

Dennis · 19 مايو 2026

Blockstudio 7.3

يضيف Blockstudio 7.3 طبقة جديدة إلى إطار العمل: مكونات UI قابلة لإعادة الاستخدام، يمكن تصييرها مثل أي كتلة أخرى.

حوّل الإصدار 7.1 الكتل إلى تطبيقات متكاملة، وسهّل الإصدار 7.2 فحص المشاريع الكبيرة والتحقق منها وتوزيعها، أما الإصدار 7.3 فيركز على تجربة بناء هذه التطبيقات وتحريرها يوميًا.

باختصار:

  • مكونات UI: مكتبة مكونات bsui/* مضمّنة واختيارية، تدعمها WordPress التفاعلية في API.
  • التطبيقات: أمثلة app/* مضمّنة توضح كيفية تركيب مكونات UI ضمن واجهات أكبر.
  • المحرر الموسع: لوحة جانبية أوسع لتحرير حقول Blockstudio عندما تضيق مساحة الشريط الجانبي.
  • محددات الأصول ذات النطاق المحدد: يمكن لأصول CSS وSCSS استخدام %selector% لاستهداف فئة غلاف الكتلة مباشرةً.
  • تبعيات الإضافات: يمكن للكتل اشتراط إضافات WordPress نشطة، مع قيود اختيارية على الإصدارات.
  • سياسات المحرر: يمكن لـ blockstudio.json تهيئة الكتل والأنماط وسلوك الوسائط العام باستخدام خطافات المحرر المعتمدة على WordPress وPHP.
  • الأسماء المستعارة لعلامات الكتل: أسماء مستعارة مخصصة لتأليف علامات الكتل.
  • التحليل الساكن والوثائق: تغطية أفضل لـ PHPStan لمكتبات الكتل الخارجية، إضافة إلى إنشاء وثائق الإعدادات والخطافات.
  • إصلاحات الصفحات والمحرر: تحليل أوثق للصفحات المعتمدة على الملفات، واكتشاف مرشحات Tailwind، ووضع إعادة الضبط، وعزل ذاكرة التصيير المؤقتة، والتحميل المسبق للمحرر.

مكتبة UI

يتضمن الإصدار 7.3 مكتبة مكونات مضمّنة وتطبيقات نموذجية مبنية عليها.

مكونات UI

يتضمن Blockstudio 7.3 مكتبة UI مضمّنة ضمن مساحة الأسماء bsui/*. المكونات كتل Blockstudio عادية، لذا يمكن تصييرها في القوالب والصفحات المعتمدة على الملفات والأنماط ومحتوى المنشورات باستخدام صياغة علامات الكتل نفسها التي تستخدمها بالفعل.

لا تزال مكتبة مكونات UI في المرحلة التجريبية بينما نجمع مزيدًا من الملاحظات. هدف الإصدار 7.3 هو إتاحة مجموعة المكونات الأولى والتعلم من المشاريع الفعلية وتحسين التسمية والسلوك والقيم الافتراضية قبل اعتبار واجهة API مستقرة.

المكتبة اختيارية:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

بعد تفعيلها، يمكن تصيير المكونات البسيطة مباشرةً:

HTML
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>

وتعمل أيضًا صياغة bs: الأقصر:

HTML
<bs:bsui-button label="Save" variant="default" />

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

تتضمن مجموعة المكونات الأولى عناصر أساسية للتخطيط والإجراءات والمدخلات والطبقات العائمة والتنقل والملاحظات والنماذج وعرض البيانات:

  • bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
  • bsui/input, bsui/textarea, bsui/select, bsui/checkbox, bsui/radio-group, bsui/slider, bsui/switch, bsui/number-field, bsui/password-input, bsui/phone-input, bsui/otp-input, bsui/date-input, bsui/time-picker
  • bsui/dialog, bsui/drawer, bsui/popover, bsui/menu, bsui/context-menu, bsui/menubar, bsui/tooltip, bsui/alert-dialog
  • bsui/tabs, bsui/accordion, bsui/breadcrumb, bsui/pagination, bsui/navigation-menu
  • bsui/card, bsui/table, bsui/stack, bsui/separator, bsui/aspect-ratio, bsui/badge, bsui/avatar, bsui/progress, bsui/meter, bsui/skeleton, bsui/spinner, bsui/kbd
  • bsui/form, bsui/field, bsui/field-group, bsui/file-upload, bsui/color-picker, bsui/rating

العديد من هذه الكتل مركبة. تتولى كتلة bsui/tabs الحالة التفاعلية، بينما تصف الكتل الفرعية مثل bsui/tabs-list وbsui/tabs-trigger وbsui/tabs-panel البنية.

HTML
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>

وهذا يحافظ على وضوح الترميز، بينما تتولى واجهة API التفاعلية إدارة الحالة والسلوك.

أمثلة التطبيقات

تحتوي مساحة الأسماء app/* على أمثلة مبنية من مكونات UI نفسها.

ليست هذه الأمثلة إطار عمل منفصلًا، بل تطبيقات مرجعية لواجهات Blockstudio أكبر: كتل مركبة، وUI متداخلة، وحالة تفاعلية في API، ومواضع تلتقي فيها مكونات UI مع ميزات RPC أو ميزات مدعومة بقواعد البيانات.

HTML
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>

تتضمن مكتبة UI أيضًا وثائقها الخاصة ومرجعًا مباشرًا للمكونات. فسلوك المكونات ليس مجرد مجموعة من القوالب؛ بل هو جزء من عقد إطار العمل، ويظل متسقًا مع نمو المكتبة.

التأليف والتحرير

تجعل عدة تغييرات تأليف الكتل وتحريرها أسهل.

المحرر الموسع

قد تضيق مساحة الشريط الجانبي للفحص سريعًا عند تحرير الكتل المعقدة. ويبرز ذلك خصوصًا مع الحقول المتكررة وحقول الشفرة والنص المنسق والمجموعات المتداخلة.

يضيف Blockstudio 7.3 إجراءً لفتح المحرر الموسع في لوحة فحص الكتلة. يفتح الإجراء لوحة أوسع من الجانب الأيمن للمحرر، ويعرض فيها حقول Blockstudio نفسها.

النقطة الأساسية هي أن هذا النظام يستخدم الحقول نفسها. فلا يكرر عرض الحقول، ولا يقدم مسار حفظ ثانيًا، كما أن التغييرات في المحرر الموسع تحدّث الكتلة المحددة تمامًا مثل التغييرات التي تُجرى في الشريط الجانبي المعتاد.

استخدمه عندما يكون الشريط الجانبي مناسبًا للتصفح، لكنه ضيق جدًا لإدخال البيانات فعليًا.

محددات الأصول ذات النطاق المحدد

كان Blockstudio يدعم بالفعل %selector% لحقول الشفرة. وفي الإصدار 7.3، يمكن لأصول CSS وSCSS الخاصة بالكتل استخدام نمط التأليف نفسه.

في ملف CSS، يتمدد %selector% إلى الفئة المحددة النطاق للكتلة:

CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

يتيح ذلك تنسيق عنصر الغلاف الفعلي:

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>

تظل المحددات العادية في *.scoped.css تستهدف العناصر الفرعية. أما %selector% فهو الخطاف الصريح للعنصر الجذر للكتلة.

تبعيات الإضافات

يمكن للكتل الآن إعلان تبعيات إضافات WordPress داخل المفتاح blockstudio في block.json.

يتحقق النموذج البسيط من تفعيل كل معرّف إضافة مُدرج:

JSON
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}

يضيف نموذج الكائن قيودًا على الإصدارات:

JSON
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}

المعرّفات هي معرّفات إضافات WordPress، وتطابق نظام تبعيات الإضافات الأساسي في WordPress. يحل Blockstudio الإضافات النشطة إلى تلك المعرّفات، ويتخطى التسجيل إذا كانت إضافة مطلوبة مفقودة أو غير نشطة أو دون الإصدار المطلوب.

يستخدم قيد الإصدار نموذج المقارنة نفسه الذي يستخدمه PHP في version_compare(). ويُعامل الإصدار المجرد مثل "6" على أنه >=6.

يفيد هذا للكتل التي لا تعمل إلا عند توفر إضافة: بطاقات منتجات WooCommerce، وتكاملات النماذج، وتكاملات SEO، ومكونات العضوية، وأدوات الحجز، أو عناصر الإدارة UI المرتبطة بإضافة خارجية.

سياسات المحرر

أصبح ملف blockstudio.json أكثر فائدة أيضًا بوصفه ملفًا لسياسات المحرر على مستوى المشروع.

يضيف الإصدار 7.3 طبقة سياسات blockEditor مدعومة بـPHP لإعدادات WordPress التي يتيحها بالفعل عبر خطافات جانب الخادم. وهذا يعني أنه يمكنك تحديد سلوك عام لأداة إدراج الكتل والأنماط والوسائط دون شحن تعليمات برمجية مخصصة لمرة واحدة للقالب.

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}

تقتصر المرحلة الأولى عمدًا على ما تدعمه PHP: الكتل المسموح بها والممنوعة، وتحميل دليل الكتل، وتسميات فئات أداة الإدراج وترتيبها، ومصادر الأنماط وفئاتها، وOpenverse، وخيارات أحجام الصور، وإظهار عناصر واجهة المستخدم القديمة، وإزالة أنماط الكتل المسجلة بواسطة PHP.

لا تحاول هذه الميزة إعادة كتابة القيم الافتراضية العشوائية لكتل النواة. فإعدادات مثل core/columns.isStackedOnMobile تقع ضمن تدفق تسجيل JavaScript لمحرر الكتل، لذا تحتاج إلى API منفصل وأكثر صراحة بدلًا من حشرها في ملف JSON.

الأسماء المستعارة لعلامات الكتل

أضيف مرشح للأسماء المستعارة إلى علامات الكتل:

PHP
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});

يتيح ذلك للمشروع تعريف علامات تسهّل التأليف، مع استمرار حلها داخليًا إلى اسم الكتلة المعتمد.

HTML
<bs:theme-button label="Continue" />

يفيد هذا على نحو خاص عند تأليف قوالب كثيرة الاستخدام لـUI، حيث تكون أسماء الكتل المعتمدة صحيحة، لكنها ليست دائمًا الأسهل في التأليف.

الأدوات والموثوقية

شهد التحليل الساكن والموثوقية وأدوات الأداء تقدمًا.

التحليل الساكن وإنشاء الوثائق

اكتسبت إضافة PHPStan دعمًا لجذور مسح صريحة لمكتبات الكتل الخارجية. وهذا يعني أن المشروع يستطيع التحقق من علامات <bs:*> و<block> مقابل الكتل الموجودة خارج الإضافة أو القالب الحالي، مع إبقاء تلك الجذور مخصصة للسجل لأغراض التحليل.

وُسعت أيضًا عمليات التحقق من المخطط لتشمل البيانات الوصفية للصفحات وpluginDependencies، مما يسهل اكتشاف إعدادات الإصدار غير الصالحة قبل وصولها إلى WordPress.

يشمل إنشاء الوثائق الآن مراجع المرشحات لإعدادات وخطافات PHP. وتزداد أهمية ذلك مع تحول blockstudio.json إلى ملف سياسات فعلي للمشروع بدلًا من مجرد مجموعة مفاتيح تبديل متناثرة.

موثوقية الصفحات والمحرر

يتضمن الإصدار 7.3 أيضًا مجموعة من الإصلاحات المتعلقة بالصفحات المعتمدة على الملفات وتصيير المحرر ووضع إعادة الضبط.

أصبح تحليل الصفحات المعتمد على الملفات يدعم الآن تعيينات الحاويات المخصصة الواعية بالسمات أثناء تحليل HTML. كما تُحل وسوم الصفحات bs: الآن مساحات أسماء الكتل ذات الواصلة بشكل صحيح، لذا لم تعد أسماء مثل custom-theme/card تربك المحلل.

أصبحت وسوم الحاويات العامة غير الأساسية تُسلسَل الآن بصيغة innerContent صالحة عندما لا توفر ترميزًا للحاوية. وهذا يجعل محتوى الصفحات المتزامن أكثر قابلية للتوقع ويحافظ على صلاحية تسلسل كتل WordPress.

حصل المحرر على مجموعة من الإصلاحات المتعلقة بسلوك المعاينة والتحميل المسبق:

  • Tailwind المحرر CSS يتضمن الآن مرشحي الأصناف من قوالب الصفحات المستندة إلى الملفات.
  • تحافظ التحميلات المسبقة للمحرر على أصناف أغلفة RichText للكتل المتكررة من النوع نفسه.
  • تطابق التحميلات المسبقة للمحرر الكتل التي تُوسَّع قيم حقولها الافتراضية بواسطة Gutenberg، لكنها تُحذف من ترميز الكتل المحفوظ.
  • تُتجاهل السمات الافتراضية المسجلة التي يوسّعها Gutenberg قبل مقارنة مفاتيح ذاكرة التخزين المؤقت للتصيير.
  • تحتفظ معاينات تصيير المحرر وأداة الإدراج الآن بإدخالات منفصلة في ذاكرة التخزين المؤقت، حتى عند اشتراكها في معرّف عميل واحد.
  • يعمل bs_get_group() الآن بسلاسة مع مجموعات الحقول المخصصة المعاد استخدامها، بما فيها المجموعات التي يطابق معرّفها اسم الحقل المخصص، ولا يستخرج إلا البادئات المطابقة تمامًا.
  • تربط حقول الروابط التي تحتوي على withCreateSuggestion تدفق إنشاء LinkControl ‏WordPress على النحو الصحيح، وتنشئ صفحات مسودة عبر REST API.
  • تُنفَّذ الآن قوالب الكتل PHP مرة واحدة لكل تصيير بدلًا من تشغيل تضمين تمهيدي مُهمَل.

جرى أيضًا إحكام وضع إعادة الضبط. فهو الآن يعادل قواعد عرض كتل محرر Gutenberg وهوامشها الرأسية لأنواع المقالات المهيأة، ويزيل أنماط محتوى WordPress iframe وإعادة ضبطه عند الحاجة، ويوفر تراكبات أنظف للتحويم والتحديد في Blockstudio.

وُسّع أيضًا نطاق اختبارات الانحدار لأنماط InnerBlocks المعقدة ليشمل كتل Blockstudio المتداخلة، وذلك للتحقق من مسار تصيير المحرر في حالات إدراج الأنماط التي يصعب رصدها يدويًا.

أدوات قياس الأداء

يمكن الآن لمسبارات blockstudio-perf=1 المحلية المجهولة إصدار ترويسات Server-Timing دون حقن لوحة التصحيح.

تشمل قياسات التوقيت الآن أجزاء أكثر من دورة البناء: الاكتشاف، ومعالجة الأصول، والتسجيل، والتجاوزات. وهذا يسهّل معرفة موضع استهلاك الوقت فعلًا دون تفعيل UI مرئي لقياس الأداء.

لماذا يهم هذا الإصدار

المحور الرئيسي للإصدار 7.3 هو التركيب.

تسهّل المكونات UI تركيب واجهات التطبيقات. ويسهّل المحرر الموسّع تحرير الكتل الأكبر. وتتيح تبعيات الإضافات للكتل وصف سياق الإضافة الذي تحتاج إليه. وتنقل سياسات المحرر قواعد محرر الكتل على مستوى المشروع إلى blockstudio.json. وتجعل الأسماء البديلة لوسوم الكتل تأليف القوالب أسهل. كما تجعل إصلاحات المحلل وPHPStan والمحرر هذه التركيبات أكثر موثوقية عند مرورها عبر WordPress.

لا يزال Blockstudio معتمدًا على الملفات. ولا تزال الكتل مجلدات، والقوالب هي التي تنفذ العمل. لكن إطار العمل بات الآن يضم طبقة UI أقوى فوق هذا الأساس.