Tillgångar
Blockstudio tillhandahåller en konfigurationsfri pipeline för blocktillgångar. Lägg CSS-, SCSS- eller JavaScript-filer bredvid blocket så kompileras, minifieras och läggs de automatiskt i kön.
- Registrera tillgångar: Filnamnskonventioner och beteende för köläggning
- Bearbetning: Kompilering av SCSS, ES module-importer och minifiering
- Kodfält: Redigera kod direkt via fälttypen för kod
Granska ett blocks resurser
bs_block_assets('theme/card') returnerar de identifierade frontend- och redigeringsytetillgångarna för ett registrerat Blockstudio-block. Anropa den efter blockregistreringen, på init eller senare.
Okända block, block som inte är Blockstudio och block utan tillgångar returnerar [].
Hjälpfunktionen renderar inte blocket, köar inte något och utlöser ingen kompilering.
$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ärstyleför CSS ochmoduleför JavaScript. Blockstudios filbaserade JavaScript-tillgångar använder ES-moduler, inklusive infogade skript.handleär den stabila tillgångsidentifierare som används av renderaren i Blockstudio och filtretblockstudio/assets/disable. Den behöver inte köas i WordPress.urlär den lösta URL för den befintliga kompilerade tillgången, inklusive dess version, eller källans URL när det inte finns någon kompilerad fil. Den ärnullför infogade tillgångar.inlineskiljer infogad<style>/<script>-utdata från externa filer.scopelistar de sammanhang där tillgången gäller:frontendocheditorför delade filer, och bara ett för vy- och redigerarfiler.htmlinnehåller den färdiga taggen från den vanliga tillgångsrenderaren. Infogat innehåll, avgränsad CSS, UI-stilsättning och filter som inaktiverar vid rendering hanteras på samma sätt som vanlig blockutdata.
Filer med SCSS som saknas, är tomma, inaktiverade eller inte kompilerade utelämnas. Administratörs- och blockredigerarens tillgångar i överordnade dokument som köas av WordPress utesluts. Listan begränsas till blockets egna identifierade filer. Det är inte en beroendeöversikt: nästlade block, kodfältsvärden, handtag som köas av WordPress, modulimporter CSS, Tailwind och delade körmiljöer för UI/Interactivity kan vara beroende av renderat innehåll. Använd Render::document() för en komplett, fristående förhandsgranskning. Använd bs_block_fields() för att granska de registrerade fältdefinitionerna.