HTML segédfüggvények
Előfordulhat, hogy attribútumértékeket kell használnia a(z) CSS vagy JS fájlokban. A(z) Blockstudio segédfüggvényeket biztosít az attribútumok adatattribútumként vagy CSS változóként való rendereléséhez.
Példablokk
Tegyük fel, hogy van egy blokkunk a következő attribútumokkal:
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
Adatattribútumok
A(z) bs_render_attributes függvény adatattribútumként rendereli az attribútumokat:
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
Kimenet:
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
Attribútumok szűrése
Adjon meg egy második paramétert annak megadásához, hogy mely attribútumokat kell renderelni:
PHP
<h1 <?php bs_render_attributes($a, ['color']); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
<h1 {{ fn('bs_render_attributes', a, ['color']) }}>
{{ a.message }}
</h1>
Kimenet:
<h1 data-color="#7C3AED">
Hello
</h1>
Visszaadás renderelés nélkül
A(z) bs_attributes használatával visszhangozás nélkül kaphatja meg a karakterláncot:
<?php $attrs = bs_attributes($a); ?>
CSS változók
A(z) bs_render_variables függvény CSS változóként rendereli az attribútumokat:
PHP
<h1 style="<?php bs_render_variables($a); ?>">
<?php echo $a['message']; ?>
</h1>
Twig
<h1 style="{{ fn('bs_render_variables', a) }}">
{{ a.message }}
</h1>
Kimenet:
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
Változók szűrése
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
Kimenet:
<h1 style="--color: #7C3AED;">
Hello
</h1>
Visszaadás renderelés nélkül
A(z) bs_variables használatával visszhangozás nélkül kaphatja meg a karakterláncot:
<?php $vars = bs_variables($a); ?>
Karakterlánccá alakítás
Mindkét függvény kötőjeles kisbetűs formára alakítja az attribútumazonosítókat:
| Bemenet | Kimenet |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
Használat a(z) CSS fájlban
.my-block h1 {
color: var(--color);
}
Használat a(z) JavaScript fájlban
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;