Помощни функции за 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); ?>
Преобразуване в низ
И двете функции преобразуват ID-тата на атрибутите в 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;