Aller au contenu

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

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

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.

CSS
%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 :

HTML
<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.

JSON
{
  "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

JSON
{
  "$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.

JSON
{
  "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 :

Scss
%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.