Hoppa till innehåll

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.

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.

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 är style för CSS och module fö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 filtret blockstudio/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 är null för infogade tillgångar.
  • inline skiljer infogad <style>/<script>-utdata från externa filer.
  • scope listar de sammanhang där tillgången gäller: frontend och editor för delade filer, och bara ett för vy- och redigerarfiler.
  • html innehå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.