HTML pagalbinės funkcijos
Kartais atributų reikšmes reikia naudoti CSS arba JS failuose. Blockstudio pateikia pagalbines funkcijas, kurios atvaizduoja atributus kaip duomenų atributus arba CSS kintamuosius.
Pavyzdinis blokas
Tarkime, turime bloką su šiais atributais:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
Duomenų atributai
Funkcija bs_render_attributes atvaizduoja atributus kaip duomenų atributus:
PHP
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
Išvestis:
HTML
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
Atributų filtravimas
Perduokite antrą parametrą, kad nurodytumėte, kuriuos atributus atvaizduoti:
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>
Išvestis:
HTML
<h1 data-color="#7C3AED">
Hello
</h1>
Grąžinimas neatvaizduojant
Naudokite bs_attributes, kad gautumėte eilutę jos neišvesdami:
PHP
<?php $attrs = bs_attributes($a); ?>
CSS kintamieji
Funkcija bs_render_variables atvaizduoja atributus kaip CSS kintamuosius:
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>
Išvestis:
HTML
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
Kintamųjų filtravimas
PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
Išvestis:
HTML
<h1 style="--color: #7C3AED;">
Hello
</h1>
Grąžinimas neatvaizduojant
Naudokite bs_variables, kad gautumėte eilutę jos neišvesdami:
PHP
<?php $vars = bs_variables($a); ?>
Eilutės konvertavimas
Abi funkcijos konvertuoja atributų ID į kebab-case formatą:
| Įvestis | Išvestis |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
Naudojimas su CSS
CSS
.my-block h1 {
color: var(--color);
}
Naudojimas su JavaScript
JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;