Aller au contenu

Composants

Les composants sont des blocs Blockstudio qui suivent tout le processus (attributs, modèles, ressources, RPC, Tailwind), mais qui n’apparaissent pas dans l’inserteur de l’éditeur WordPress. Ils sont conçus pour créer des éléments UI réutilisables, rendus uniquement par programmation.

block.json

Définissez la propriété component sur true dans l’objet blockstudio :

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "description",
        "type": "textarea",
        "label": "Description"
      }
    ]
  }
}

Rendu

Les composants peuvent être rendus de deux façons :

Rendu sous forme de chaîne

Utilisez des balises <bs:> dans les modèles de page ou le contenu des publications :

HTML
<bs:my-theme-card title="My Card" description="Card content." />

PHP

Utilisez bs_render_block() ou bs_block() dans les modèles PHP :

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'attributes' => [
    'title' => 'My Card',
    'description' => 'Card content.',
  ],
]);

Fonctionnalités prises en charge

Les composants prennent en charge toutes les fonctionnalités de Blockstudio :

  • Attributs et types de champs
  • Modèles PHP, Twig et Blade
  • Ressources CSS/SCSS (chargées lors du rendu du composant)
  • Tailwind CSS
  • Fonctions serveur (RPC)
  • Styles isolés

Éléments non pris en charge

Les composants n’apparaissant jamais dans l’éditeur :

  • L’aperçu de bloc dans l’éditeur n’est pas disponible
  • La recherche dans l’inserteur de blocs ne les trouvera pas
  • registerBlockType() n’est jamais appelé pour les composants