Treci la conținut

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;