أصول حقل الأكواد
إلى جانب الأنماط والنصوص البرمجية الثابتة كملفات، يدعم Blockstudio أيضًا كتل الأصول الديناميكية عبر حقل الأكواد. ويمكن تقييد هذه الكتل بنطاق الكتلة حسب حالة الاستخدام.
الاستخدام الأساسي
في أبسط الحالات، يمكنك عرض محتوى حقل الأكواد يدويًا في قالبك.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
محدد النطاق
لتجنب التعارض مع الكتل الأخرى، يمكنك استخدام المتغير %selector% داخل حقل الأكواد مع useBlockProps في قالب العرض.
في حقول الأكواد، يستهدف %selector% نسخة الكتلة الفردية. أما في ملفات CSS وSCSS، فيستهدف %selector% الصنف المشترك المحدد النطاق للكتلة بدلًا من ذلك.
مثال
لنفترض أننا نريد استهداف الوسم h1 من المثال أعلاه في حقل الأكواد.
%selector% h1 {
color: red;
}
الآن، سينفذ Blockstudio ثلاثة أمور:
- ينشئ معرّفًا فريدًا لنسخة الكتلة
- يستبدل
%selector%بالمعرّف الفريد - يضيف المحدد نفسه إلى العنصر المحدد بـ
useBlockProps
ستكون النتيجة النهائية على نحو مشابه لما يلي:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
العرض التلقائي
قد يكون الاضطرار دائمًا إلى عرض وسم النمط يدويًا أمرًا مرهقًا. لتسهيل هذه العملية، يمكنك استخدام السمة asset داخل حقل الكود.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
سيُنشئ هذا تلقائيًا وسوم style لكتل الأكواد المحددة على أنها css، وينقلها إلى رأس المستند. أما الحقول المحددة باللغة javascript، فستُنشأ لها وسوم script بدلًا من ذلك، وتوضع في نهاية المتن.
في الإضافات
عند استخدام حقول الأكواد داخل الإضافات، لا تكون السمة asset ضرورية. سيعرض Blockstudio محتوى حقل الكود تلقائيًا كأصل إذا كانت اللغة css أو javascript.
مثال
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
لا حاجة إلى إعداد إضافي. سيعرض ما سبق حقل كود لكل كتلة core/* في الشريط الجانبي، وسيعرض المحتوى تلقائيًا كأصل على الصفحة.
SCSS
تدعم حقول الأكواد تجميع SCSS. عيّن اللغة إلى scss وسيجمع Blockstudio القيمة عبر ScssPhp قبل عرضها بصيغة CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
تعمل ميزات SCSS مثل المتغيرات والتداخل والمزائج كلها:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
في المحرر، يُجمع SCSS على الخادم في الوقت الفعلي لتتمكن من رؤية النتيجة أثناء الكتابة. وفي الواجهة الأمامية، يحدث التجميع أثناء عرض الكتلة.