Vai al contenuto

Risorse

Blockstudio offre una pipeline di risorse a configurazione zero per i vostri blocchi. Aggiungete file CSS, SCSS o JavaScript accanto al vostro blocco: verranno compilati, minimizzati e accodati automaticamente.

Esaminare gli asset di un blocco

bs_block_assets('theme/card') restituisce gli asset individuati per il frontend e la canvas dell’editor di un blocco Blockstudio registrato. Chiamatelo dopo la registrazione del blocco, su init o versioni successive. I blocchi sconosciuti, quelli non Blockstudio e quelli senza asset restituiscono []. L’helper non esegue il rendering del blocco, non accoda nulla e non avvia la compilazione.

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 per CSS e module per JavaScript. Gli asset JavaScript basati su file di Blockstudio usano moduli ES, inclusi gli script inline.
  • handle è l’identificatore stabile dell’asset usato dal renderer di Blockstudio e dal filtro blockstudio/assets/disable. Non è necessario accodarlo in WordPress.
  • url è l’URL risolto dell’asset compilato esistente, inclusa la sua versione, oppure l’URL sorgente se non esiste un file compilato. Per gli asset inline è null.
  • inline distingue l’output inline <style>/<script> dai file esterni.
  • scope elenca i contesti in cui si applica l’asset: frontend e editor per i file condivisi, e uno solo per i file di view/editor.
  • html contiene il tag pronto all’uso prodotto dal renderer standard degli asset. I contenuti inline, CSS con ambito specifico, i livelli di stile UI e i filtri che disabilitano il rendering vengono gestiti come nel normale output dei blocchi.

I file SCSS mancanti, vuoti, disabilitati e non compilati vengono omessi. Le risorse WordPress accodate dall’amministrazione e dal documento principale dell’editor a blocchi sono escluse. L’elenco è limitato ai file individuati del blocco. Non include tutte le dipendenze: i blocchi annidati, i valori dei campi di codice, gli handle WordPress accodati, le importazioni dei moduli CSS, Tailwind e i runtime condivisi di UI/Interactivity possono dipendere dal contenuto renderizzato. Usate Render::document() per un’anteprima completa e autonoma. Usate bs_block_fields() per esaminare le definizioni dei campi registrati.