Pereiti prie turinio

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;