أدوات HTML المساعدة
قد تحتاج أحيانًا إلى استخدام قيم السمات في ملفات CSS أو JS. يوفر Blockstudio دوال مساعدة لعرض السمات كسمات بيانات أو متغيرات CSS.
مثال على كتلة
لنفترض أن لدينا كتلة بالسمات التالية:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
سمات البيانات
تعرض الدالة bs_render_attributes السمات كسمات بيانات:
PHP
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
الناتج:
HTML
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
تصفية السمات
مرر معلمة ثانية لتحديد السمات المطلوب عرضها:
PHP
PHP
<h1 <?php bs_render_attributes($a, ['color']); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a, ['color']) }}>
{{ a.message }}
</h1>
الناتج:
HTML
<h1 data-color="#7C3AED">
Hello
</h1>
الإرجاع دون عرض
استخدم bs_attributes للحصول على السلسلة النصية دون إخراجها:
PHP
<?php $attrs = bs_attributes($a); ?>
متغيرات CSS
تعرض الدالة bs_render_variables السمات كمتغيرات CSS:
PHP
PHP
<h1 style="<?php bs_render_variables($a); ?>">
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 style="{{ fn('bs_render_variables', a) }}">
{{ a.message }}
</h1>
الناتج:
HTML
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
تصفية المتغيرات
PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
الناتج:
HTML
<h1 style="--color: #7C3AED;">
Hello
</h1>
الإرجاع دون عرض
استخدم bs_variables للحصول على السلسلة النصية دون إخراجها:
PHP
<?php $vars = bs_variables($a); ?>
تحويل السلاسل النصية
تحوّل كلتا الدالتين معرّفات السمات إلى صيغة kebab-case:
| الإدخال | الناتج |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
الاستخدام في CSS
CSS
.my-block h1 {
color: var(--color);
}
الاستخدام في JavaScript
JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;