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;