Aller au contenu

Utilitaires HTML

Vous devez parfois utiliser les valeurs des attributs dans vos fichiers CSS ou JS. Blockstudio fournit des fonctions d’assistance pour rendre les attributs sous forme d’attributs de données ou de variables CSS.

Exemple de bloc

Imaginons un bloc avec les attributs suivants :

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

Attributs de données

La fonction bs_render_attributes rend les attributs sous forme d’attributs de données :

PHP

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

Twig

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

Résultat :

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

Filtrage des attributs

Passez un deuxième paramètre pour préciser les attributs à rendre :

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>

Résultat :

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

Retour sans rendu

Utilisez bs_attributes pour obtenir la chaîne sans l’afficher :

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

Variables CSS

La fonction bs_render_variables rend les attributs sous forme de 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>

Résultat :

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

Filtrage des variables

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

Résultat :

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

Retour sans rendu

Utilisez bs_variables pour obtenir la chaîne sans l’afficher :

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

Conversion de chaîne

Les deux fonctions convertissent les identifiants d’attributs en kebab-case :

Entrée Sortie
myAttribute my-attribute
my_attribute my-attribute
backgroundColor background-color

Utilisation dans CSS

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

Utilisation dans JavaScript

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