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