Saltar al contenido

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