Utilitare HTML
Uneori trebuie să folosiți valorile atributelor în fișierele CSS sau JS. Blockstudio oferă funcții ajutătoare pentru redarea atributelor ca atribute de date sau variabile CSS.
Bloc exemplu
Să presupunem că avem un bloc cu următoarele atribute:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
Atribute de date
Funcția bs_render_attributes redă atributele ca atribute de date:
PHP
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
Rezultat:
HTML
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
Filtrarea atributelor
Transmiteți un al doilea parametru pentru a specifica ce atribute să fie redate:
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>
Rezultat:
HTML
<h1 data-color="#7C3AED">
Hello
</h1>
Returnare fără redare
Folosiți bs_attributes pentru a obține șirul fără a-l afișa:
PHP
<?php $attrs = bs_attributes($a); ?>
Variabile CSS
Funcția bs_render_variables redă atributele ca variabile 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>
Rezultat:
HTML
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
Filtrarea variabilelor
PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
Rezultat:
HTML
<h1 style="--color: #7C3AED;">
Hello
</h1>
Returnare fără redare
Folosiți bs_variables pentru a obține șirul fără a-l afișa:
PHP
<?php $vars = bs_variables($a); ?>
Conversia șirurilor
Ambele funcții convertesc ID-urile atributelor în format kebab-case:
| Intrare | Rezultat |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
Utilizare în CSS
CSS
.my-block h1 {
color: var(--color);
}
Utilizare în JavaScript
JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;