Saltar al contenido

Recursos

Blockstudio ofrece una canalización de recursos sin configuración para sus bloques. Coloque archivos CSS, SCSS o JavaScript junto a su bloque y se compilarán, minimizarán y añadirán automáticamente.

  • Registro de recursos: Convenciones de nombres de archivo y comportamiento de inclusión
  • Procesamiento: Compilación de SCSS, importaciones de módulos ES y minificación
  • Campo de código: Edición de código en línea mediante el tipo de campo de código

Inspección de los recursos de un bloque

bs_block_assets('theme/card') devuelve los recursos de frontend y del lienzo del editor detectados para un bloque Blockstudio registrado. Llámelo después de registrar el bloque, en init o en una fase posterior. Los bloques desconocidos, los bloques que no sean Blockstudio y los bloques sin recursos devuelven []. El helper no renderiza el bloque, no pone nada en cola ni activa la compilación.

PHP
$assets = bs_block_assets('theme/card');

// Each entry has this shape:
[
  'type' => 'style',
  'handle' => 'blockstudio-theme-card-style-css',
  'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
  'inline' => false,
  'scope' => ['frontend', 'editor'],
  'html' => '<link ...>',
];
  • type es style para CSS y module para JavaScript. Los recursos JavaScript de Blockstudio basados en archivos usan módulos ES, incluidos los scripts en línea.
  • handle es el identificador de recurso estable que usan el renderizador de Blockstudio y el filtro blockstudio/assets/disable. No es necesario ponerlo en cola en WordPress.
  • url es la URL resuelta del recurso compilado existente, incluida su versión, o la URL de origen cuando no existe ningún archivo compilado. Es null para los recursos en línea.
  • inline distingue la salida en línea <style>/<script> de los archivos externos.
  • scope enumera los contextos en los que se aplica el recurso: frontend y editor para los archivos compartidos, y solo uno para los archivos de vista/editor.
  • html contiene la etiqueta lista para usar del renderizador de recursos habitual. El contenido en línea, CSS con ámbito, las capas de estilo UI y los filtros de desactivación en tiempo de renderizado se gestionan igual que en la salida normal de los bloques.

Los archivos SCSS que faltan, están vacíos, desactivados o no se han compilado se omiten. Se excluyen los recursos del documento principal, incluidos los añadidos a la cola de carga con WordPress, tanto en el administrador como en el editor de bloques. La lista se limita a los archivos propios del bloque que se han detectado. No incluye todas las dependencias: los bloques anidados, los valores de los campos de código, los identificadores añadidos a la cola de carga con WordPress, las importaciones de módulos CSS, Tailwind y los entornos de ejecución compartidos de UI/Interactivity pueden depender del contenido renderizado. Use Render::document() para obtener una vista previa completa y autónoma. Use bs_block_fields() para inspeccionar las definiciones de los campos registrados.