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.
$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 ...>',
];
typeesstylepara CSS ymodulepara JavaScript. Los recursos JavaScript de Blockstudio basados en archivos usan módulos ES, incluidos los scripts en línea.handlees el identificador de recurso estable que usan el renderizador de Blockstudio y el filtroblockstudio/assets/disable. No es necesario ponerlo en cola en WordPress.urles la URL resuelta del recurso compilado existente, incluida su versión, o la URL de origen cuando no existe ningún archivo compilado. Esnullpara los recursos en línea.inlinedistingue la salida en línea<style>/<script>de los archivos externos.scopeenumera los contextos en los que se aplica el recurso:frontendyeditorpara los archivos compartidos, y solo uno para los archivos de vista/editor.htmlcontiene 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.