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.
- Registrering af aktiver: Filnavnskonventioner og adfærd ved tilføjelse til køen
- Behandling:SCSS-kompilering, ES-modulimporter og minificering
- Kodefelt: Redigering af kode direkte via kodetypefeltet
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.
$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 ...>',
];
typeerstylefor CSS ogmodulefor JavaScript. Blockstudios filbaserede JavaScript-aktiver bruger ES-moduler, også til inline-scripts.handleer den stabile aktividentifikator, der bruges af Blockstudios renderer og filteretblockstudio/assets/disable. Den behøver ikke at blive sat i kø i WordPress.urler den opløste URL for det eksisterende kompilerede aktiv, inklusive dets version, eller kilde-URL, når der ikke findes en kompileret fil. Den ernullfor inline-aktiver.inlineskelner mellem inline-<style>/<script>-output og eksterne filer.scopeangiver de sammenhænge, hvor aktivet gælder:frontendogeditorfor delte filer og kun én for visnings-/editorfiler.htmlindeholder 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.