Ressources du champ de code
En plus des styles et scripts statiques sous forme de fichiers, Blockstudio prend également en charge les blocs de ressources dynamiques via le champ de code. Selon votre cas d’utilisation, vous pouvez limiter leur portée au bloc.
Utilisation de base
Dans le cas le plus simple, vous pouvez afficher manuellement le contenu du champ de code dans votre modèle.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Sélecteur limité au bloc
Pour éviter les conflits avec d’autres blocs, vous pouvez utiliser la variable %selector% dans le champ de code, avec useBlockProps, dans votre modèle de rendu.
Dans les champs de code, %selector% cible l’instance de bloc individuelle. Dans les fichiers CSS et SCSS, %selector% cible plutôt la classe commune au bloc qui limite sa portée.
Exemple
Imaginons que nous voulions cibler la balise h1 de l’exemple ci-dessus dans notre champ de code.
%selector% h1 {
color: red;
}
Blockstudio va alors effectuer trois opérations :
- Créer un identifiant unique pour cette instance de bloc
- Remplacer
%selector%par l’identifiant unique - Ajouter le même sélecteur à l’élément marqué avec
useBlockProps
Le résultat final ressemblera à ceci :
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Rendu automatique
Devoir toujours générer manuellement la balise de style peut être fastidieux. Pour simplifier ce processus, vous pouvez utiliser l’attribut asset dans le champ de code.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Cela créera automatiquement des balises style pour les blocs de code marqués comme css et les déplacera dans l’en-tête du document. Pour les champs dont la langue est marquée comme javascript, des balises script seront créées à la place et placées à la fin du corps.
Dans les extensions
Lors de l’utilisation de champs de code dans les extensions, l’attribut asset n’est pas nécessaire. Blockstudio générera automatiquement le contenu du champ de code comme ressource si la langue est css ou javascript.
Exemple
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Aucune configuration supplémentaire n’est nécessaire. Le code ci-dessus affichera un champ de code pour chaque bloc core/* dans la barre latérale et générera automatiquement son contenu comme ressource pour la page.
SCSS
Les champs de code prennent en charge la compilation SCSS. Définissez la langue sur scss et Blockstudio compilera la valeur avec ScssPhp avant de la générer comme CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Les fonctionnalités SCSS comme les variables, l’imbrication et les mixins fonctionnent toutes :
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Dans l’éditeur, SCSS est compilé côté serveur en temps réel pour que vous voyiez le résultat au fil de la saisie. Sur le site, la compilation a lieu pendant le rendu du bloc.