التفاعلية
يدعم Blockstudio واجهة التفاعليةWordPressAPI، التي توفر طريقة معيارية لإضافة سلوك تفاعلي من جهة العميل إلى كتل المحتوى. عيّن interactivity في block.json، ويتولى Blockstudio تحميل API في الواجهة الأمامية وفي المحرر.
الإعداد
فعّل Interactivity API بإضافة interactivity إلى المفتاح blockstudio في block.json:
{
"name": "my-theme/interactive-block",
"title": "Interactive Block",
"category": "text",
"icon": "star-filled",
"description": "A block with interactive behavior.",
"blockstudio": {
"interactivity": true
}
}
يمكنك أيضًا استخدام صيغة الكائن:
{
"blockstudio": {
"interactivity": {
"enqueue": true
}
}
}
الصيغتان متكافئتان.
القالب
أضف توجيهات Interactivity API إلى قالب الكتلة. تحدد السمة data-wp-interactive نطاق أسماء المخزن، وتتحكم سمات data-wp-* الأخرى في السلوك التفاعلي.
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
النص البرمجي
أنشئ ملف script.js في مجلد الكتلة يستورد من @wordpress/interactivity ويهيّئ المخزن. استدعِ store() في المستوى الأعلى للوحدة:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
يحمّل Blockstudio script.js كوحدة ES، وينشئ تلقائيًا خريطة الاستيراد اللازمة لحل @wordpress/interactivity.
لا حاجة إلى script.js إلا إذا كانت كتلتك تعرّف إجراءات أو استدعاءات مخصصة. تعمل الكتل التي تستخدم التوجيهات التصريحية مع data-wp-context فقط (مثل data-wp-bind--hidden أو data-wp-text) دون أي JavaScript.
حالة الخادم
يمكنك استخدام wp_interactivity_state() في القالب لتهيئة الحالة من PHP:
<?php
wp_interactivity_state( 'myBlock', array(
'message' => 'Hello from the server',
'count' => get_comments_number(),
) );
?>
<div useBlockProps
data-wp-interactive="myBlock">
<p data-wp-text="state.message">loading...</p>
<p data-wp-text="state.count">0</p>
</div>
تتوفر حالة الخادم على الواجهة الأمامية فقط. يحوّل WordPress الحالة إلى تسلسل داخل وسم نص برمجي JSON في ناتج الصفحة، ثم يقرأها API الخاص بـ Interactivity أثناء الإماهة. في المحرر، تُعرض الكتل عبر REST API، لذا لا تُضمّن بيانات الحالة في الاستجابة. استخدم data-wp-context للحالة التي يجب أن تعمل في المحرر والواجهة الأمامية معًا.
الاستدعاءات مقابل الإجراءات
تُشغّل الإجراءات بتفاعلات المستخدم (مثل data-wp-on--click). أما الاستدعاءات فتُشغّل تفاعليًا عند تغيّر الحالة أو السياق باستخدام التوجيه data-wp-watch. داخل الاستدعاءات، يمكنك استدعاء getElement() للوصول إلى عنصر DOM الأساسي:
import { store, getContext, getElement } from '@wordpress/interactivity';
store('myBlock', {
callbacks: {
updateWidth: () => {
const { ref } = getElement();
const { isOpen } = getContext();
ref.style.width = isOpen ? '100%' : '0';
},
},
});
دعم المحرر
يُحمّل API الخاص بـ Interactivity داخل إطار محرر الكتل، لذا تعمل التوجيهات التفاعلية في معاينات المحرر. ويشمل ذلك data-wp-context وdata-wp-bind--* وdata-wp-on--* وdata-wp-text وإجراءات المخزن المخصصة المعرّفة في script.js.
أمثلة كاملة تتضمن لوحات قابلة للطي وعلامات تبويب ونوافذ منبثقة وأزرار إعجاب.