Pular para o conteúdo

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.

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 é style para CSS e module para 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 filtro blockstudio/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. É null para recursos inline.
  • inline distingue a saída inline de <style>/<script> dos arquivos externos.
  • scope lista os contextos em que o recurso se aplica: frontend e editor para arquivos compartilhados, e apenas um para arquivos de visualização/editor.
  • html conté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.