Gå til indhold

Aktiver

Blockstudio tilbyder en aktivpipeline uden konfiguration til dine blokke. Læg CSS-, SCSS- eller JavaScript-filer ved siden af din blok, så kompileres, minificeres og tilføjes de automatisk til køen.

Undersøgelse af en bloks aktiver

bs_block_assets('theme/card') returnerer de fundne frontend- og editorlærredsaktiver for en registreret Blockstudio-blok. Kald den efter blokregistreringen, på init eller senere. Ukendte blokke, blokke der ikke er Blockstudio, og blokke uden aktiver returnerer []. Hjælpefunktionen renderer ikke blokken, sætter intet i kø og udlø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 er style for CSS og module for JavaScript. Blockstudios filbaserede JavaScript-aktiver bruger ES-moduler, også til inline-scripts.
  • handle er den stabile aktividentifikator, der bruges af Blockstudios renderer og filteret blockstudio/assets/disable. Den behøver ikke at blive sat i kø i WordPress.
  • url er den opløste URL for det eksisterende kompilerede aktiv, inklusive dets version, eller kilde-URL, når der ikke findes en kompileret fil. Den er null for inline-aktiver.
  • inline skelner mellem inline-<style>/<script>-output og eksterne filer.
  • scope angiver de sammenhænge, hvor aktivet gælder: frontend og editor for delte filer og kun én for visnings-/editorfiler.
  • html indeholder det klar-til-brug-tag, der kommer fra den normale aktivrenderer. Inline-indhold, afgrænset CSS, stilagene UI og filtre, der deaktiverer under rendering, håndteres på samme måde som almindeligt blokoutput.

Manglende, tomme, deaktiverede og ikke-kompilerede SCSS-filer udelades. WordPress-indlæste admin- og overordnede dokumentaktiver fra blokeditoren udelades. Listen begrænses til blokkens egne fundne filer. Den omfatter ikke hele afhængighedskæden: indlejrede blokke, værdier i kodefelter, handles indlæst af WordPress, modulimporter CSS, Tailwind og delte UI-/Interactivity-kørselsmiljøer kan afhænge af det renderede indhold. Brug Render::document() til en komplet, selvstændig forhåndsvisning. Brug bs_block_fields() til at undersøge de registrerede feltdefinitioner.