Към съдържанието

Помощни функции за HTML

Понякога трябва да използвате стойностите на атрибутите във файловете си CSS или JS. Blockstudio предоставя помощни функции за извеждане на атрибутите като атрибути за данни или променливи CSS.

Примерен блок

Да си представим блок със следните атрибути:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message"
      },
      {
        "id": "color",
        "type": "color",
        "label": "My color"
      }
    ]
  }
}

Атрибути за данни

Функцията bs_render_attributes извежда атрибутите като атрибути за данни:

PHP

PHP
<h1 <?php bs_render_attributes($a); ?>>
  <?php echo $a['message']; ?>
</h1>

Twig

Twig
<h1 {{ fn('bs_render_attributes', a) }}>
  {{ a.message }}
</h1>

Резултат:

HTML
<h1 data-message="Hello" data-color="#7C3AED">
  Hello
</h1>

Филтриране на атрибути

Подайте втори параметър, за да посочите кои атрибути да се изведат:

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>

Резултат:

HTML
<h1 data-color="#7C3AED">
  Hello
</h1>

Връщане без извеждане

Използвайте bs_attributes, за да получите низа, без да го извеждате:

PHP
<?php $attrs = bs_attributes($a); ?>

Променливи CSS

Функцията bs_render_variables извежда атрибутите като променливи 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>

Резултат:

HTML
<h1 style="--message: Hello; --color: #7C3AED;">
  Hello
</h1>

Филтриране на променливи

PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">

Резултат:

HTML
<h1 style="--color: #7C3AED;">
  Hello
</h1>

Връщане без извеждане

Използвайте bs_variables, за да получите низа, без да го извеждате:

PHP
<?php $vars = bs_variables($a); ?>

Преобразуване в низ

И двете функции преобразуват ID-тата на атрибутите в kebab-case:

Вход Резултат
myAttribute my-attribute
my_attribute my-attribute
backgroundColor background-color

Използване в CSS

CSS
.my-block h1 {
  color: var(--color);
}

Използване в JavaScript

JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;