Pāriet uz saturu

HTML utilītas

Dažkārt atribūtu vērtības jāizmanto savos CSS vai JS failos. Blockstudio nodrošina palīgfunkcijas, kas renderē atribūtus kā datu atribūtus vai CSS mainīgos.

Bloka piemērs

Iedomāsimies bloku ar šādiem atribūtiem:

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

Datu atribūti

Funkcija bs_render_attributes renderē atribūtus kā datu atribūtus:

PHP

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

Twig

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

Izvade:

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

Atribūtu filtrēšana

Norādiet otru parametru, lai izvēlētos renderējamos atribūtus:

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>

Izvade:

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

Atgriešana bez renderēšanas

Izmantojiet bs_attributes, lai iegūtu virkni, to neizvadot:

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

CSS mainīgie

Funkcija bs_render_variables renderē atribūtus kā CSS mainīgos:

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>

Izvade:

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

Mainīgo filtrēšana

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

Izvade:

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

Atgriešana bez renderēšanas

Izmantojiet bs_variables, lai iegūtu virkni, to neizvadot:

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

Virkņu konvertēšana

Abas funkcijas konvertē atribūtu ID kebab-case formātā:

Ievade Izvade
myAttribute my-attribute
my_attribute my-attribute
backgroundColor background-color

Izmantošana CSS

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

Izmantošana JavaScript

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