Componentes
Los componentes son bloques Blockstudio que siguen todo el proceso (atributos, plantillas, recursos, RPC, Tailwind), pero no aparecen en el insertador del editor WordPress. Están diseñados para crear elementos UI reutilizables que solo se representan mediante programación.
block.json
Establece la propiedad component en true dentro del objeto 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"
}
]
}
}
Renderizado
Los componentes se pueden representar de dos formas:
Representador de cadenas
Usa etiquetas <bs:> en las plantillas de página o en el contenido de las entradas:
HTML
<bs:my-theme-card title="My Card" description="Card content." />
PHP
Usa bs_render_block() o bs_block() en las plantillas PHP:
PHP
bs_render_block([
'name' => 'my-theme/card',
'attributes' => [
'title' => 'My Card',
'description' => 'Card content.',
],
]);
Funciones compatibles
Los componentes admiten todas las funciones de Blockstudio:
- Atributos y tipos de campo
- Plantillas PHP, Twig y Blade
- Recursos CSS/SCSS (que se cargan al representar el componente)
- Tailwind CSS
- Funciones de servidor (RPC)
- Estilos con ámbito
Funciones no aplicables
Como los componentes nunca aparecen en el editor:
- La vista previa del editor de bloques no está disponible
- La búsqueda del insertador de bloques no los encontrará
- Nunca se llama a
registerBlockType()para los componentes