Recursos
Blockstudio oferece um pipeline de recursos sem configuração para seus blocos. Coloque arquivos CSS, SCSS ou JavaScript junto ao bloco para que sejam compilados, minimizados e enfileirados automaticamente.
- Registro de recursos: convenções de nomenclatura de arquivos e comportamento de enfileiramento
- Processamento: compilação de SCSS, importações de módulos ES e minificação
- Campo de código: edição de código em linha por meio do tipo de campo de código
Inspecionando os recursos de um bloco
bs_block_assets('theme/card') retorna os recursos descobertos do frontend e da tela do editor de um bloco Blockstudio registrado. Chame-o após o registro do bloco, em init ou posterior. Blocos desconhecidos, blocos que não sejam Blockstudio e blocos sem recursos retornam []. O auxiliar não renderiza o bloco, não enfileira nada nem aciona a compilação.
$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éstylepara CSS emodulepara JavaScript. Os recursos JavaScript de Blockstudio baseados em arquivos usam módulos ES, incluindo scripts inline.handleé o identificador estável do recurso usado pelo renderizador de Blockstudio e pelo filtroblockstudio/assets/disable. Ele não precisa ser enfileirado em WordPress.urlé o URL resolvido do recurso compilado existente, incluindo sua versão, ou o URL de origem quando não há arquivo compilado. Énullpara recursos inline.inlinedistingue a saída inline de<style>/<script>dos arquivos externos.scopelista os contextos em que o recurso se aplica:frontendeeditorpara arquivos compartilhados, e apenas um para arquivos de visualização/editor.htmlcontém a tag pronta para uso do renderizador normal de recursos. O conteúdo inline, o CSS com escopo, as camadas de estilo UI e os filtros de desativação em tempo de renderização são tratados da mesma forma que na saída normal do bloco.
Arquivos SCSS ausentes, vazios, desativados e não compilados são omitidos. Recursos de documento principal do admin e do editor de blocos enfileirados por WordPress são excluídos. A lista se limita aos próprios arquivos descobertos do bloco. Ela não inclui o fechamento transitivo de dependências: blocos aninhados, valores de campos de código, handles enfileirados por WordPress, importações de módulos CSS, Tailwind e os runtimes compartilhados de UI/Interactivity podem depender do conteúdo renderizado. Use Render::document() para uma pré-visualização completa e autocontida. Use bs_block_fields() para inspecionar as definições dos campos registrados.