Utilitários de HTML
Às vezes, é necessário usar valores de atributos nos arquivos CSS ou JS. Blockstudio oferece funções auxiliares para renderizar atributos como atributos de dados ou variáveis CSS.
Bloco de exemplo
Imagine um bloco com os seguintes atributos:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
Atributos de dados
A função bs_render_attributes renderiza atributos como atributos de dados:
PHP
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
Saída:
HTML
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
Filtragem de atributos
Passe um segundo parâmetro para especificar quais atributos renderizar:
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>
Saída:
HTML
<h1 data-color="#7C3AED">
Hello
</h1>
Retornar sem renderizar
Use bs_attributes para obter a string sem exibi-la:
PHP
<?php $attrs = bs_attributes($a); ?>
Variáveis CSS
A função bs_render_variables renderiza atributos como variáveis 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>
Saída:
HTML
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
Filtragem de variáveis
PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
Saída:
HTML
<h1 style="--color: #7C3AED;">
Hello
</h1>
Retornar sem renderizar
Use bs_variables para obter a string sem exibi-la:
PHP
<?php $vars = bs_variables($a); ?>
Conversão de strings
Ambas as funções convertem IDs de atributos para kebab-case:
| Entrada | Saída |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
Usando em CSS
CSS
.my-block h1 {
color: var(--color);
}
Usando em JavaScript
JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;