Ugrás a tartalomhoz

HTML segédfüggvények

Előfordulhat, hogy attribútumértékeket kell használnia a(z) CSS vagy JS fájlokban. A(z) Blockstudio segédfüggvényeket biztosít az attribútumok adatattribútumként vagy CSS változóként való rendereléséhez.

Példablokk

Tegyük fel, hogy van egy blokkunk a következő attribútumokkal:

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

Adatattribútumok

A(z) bs_render_attributes függvény adatattribútumként rendereli az attribútumokat:

PHP

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

Twig

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

Kimenet:

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

Attribútumok szűrése

Adjon meg egy második paramétert annak megadásához, hogy mely attribútumokat kell renderelni:

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>

Kimenet:

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

Visszaadás renderelés nélkül

A(z) bs_attributes használatával visszhangozás nélkül kaphatja meg a karakterláncot:

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

CSS változók

A(z) bs_render_variables függvény CSS változóként rendereli az attribútumokat:

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>

Kimenet:

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

Változók szűrése

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

Kimenet:

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

Visszaadás renderelés nélkül

A(z) bs_variables használatával visszhangozás nélkül kaphatja meg a karakterláncot:

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

Karakterlánccá alakítás

Mindkét függvény kötőjeles kisbetűs formára alakítja az attribútumazonosítókat:

Bemenet Kimenet
myAttribute my-attribute
my_attribute my-attribute
backgroundColor background-color

Használat a(z) CSS fájlban

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

Használat a(z) JavaScript fájlban

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