Pular para o conteúdo

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;