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.
- Registrazione delle risorse: convenzioni di denominazione dei file e comportamento di accodamento
- Elaborazione: compilazione di SCSS, importazioni di moduli ES e minimizzazione
- Campo di codice: modifica del codice in linea tramite il tipo di campo di codice
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.
$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èstyleper CSS emoduleper 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 filtroblockstudio/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.inlinedistingue l’output inline<style>/<script>dai file esterni.scopeelenca i contesti in cui si applica l’asset:frontendeeditorper i file condivisi, e uno solo per i file di view/editor.htmlcontiene 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.