Ga naar de inhoud

Assets

Blockstudio biedt een asset-pipeline zonder configuratie voor je blokken. Plaats CSS-, SCSS- of JavaScript-bestanden naast je blok; ze worden automatisch gecompileerd, geminificeerd en aan de wachtrij toegevoegd.

  • Assets registreren: bestandsnaamconventies en gedrag bij toevoegen aan de wachtrij
  • Verwerking: compilatie van SCSS, ES-module-imports en minificatie
  • Codeveld: code inline bewerken via het codeveldtype

De assets van een blok inspecteren

bs_block_assets('theme/card') retourneert de gevonden frontend- en editorcanvas-assets van een geregistreerd Blockstudio-blok. Roep deze aan na de blokregistratie, op init of later. Onbekende blokken, niet-Blockstudio-blokken en blokken zonder assets retourneren []. De helper rendert het blok niet, voegt niets toe aan de wachtrij en start geen compilatie.

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 is style voor CSS en module voor JavaScript. De bestandsgebaseerde JavaScript-assets van Blockstudio gebruiken ES-modules, ook voor inline scripts.
  • handle is de stabiele asset-ID die wordt gebruikt door de renderer van Blockstudio en het filter blockstudio/assets/disable. Deze hoeft niet in WordPress te worden ingeladen.
  • url is de opgeloste URL van de bestaande gecompileerde asset, inclusief de versie, of de bron-URL wanneer er geen gecompileerd bestand bestaat. Deze is null voor inline-assets.
  • inline maakt onderscheid tussen inline <style>/<script>-uitvoer en externe bestanden.
  • scope vermeldt de contexten waarin de asset van toepassing is: frontend en editor voor gedeelde bestanden, en slechts één voor view-/editorbestanden.
  • html bevat de direct bruikbare tag van de normale asset-renderer. Inline-inhoud, afgebakende CSS, UI-stijl-lagen en filters die tijdens het renderen uitschakelen, worden op dezelfde manier afgehandeld als gewone blokuitvoer.

Ontbrekende, lege, uitgeschakelde en niet-gecompileerde SCSS-bestanden worden weggelaten. Door WordPress ingeladen assets van het bovenliggende document in de beheeromgeving en de blokeditor zijn uitgesloten. De lijst is beperkt tot bestanden van het blok zelf die zijn gevonden. Het is geen sluitende lijst van afhankelijkheden: geneste blokken, waarden van codevelden, door WordPress ingeladen handles, module-imports van CSS, Tailwind en gedeelde runtimes voor UI/Interactivity kunnen afhankelijk zijn van gerenderde inhoud. Gebruik Render::document()voor een complete, zelfstandige preview. Gebruik bs_block_fields() om de geregistreerde velddefinities te bekijken.