Assets
Blockstudio bietet eine Asset-Pipeline ohne Konfiguration für deine Blöcke. Lege CSS-, SCSS- oder JavaScript-Dateien neben deinem Block ab. Sie werden automatisch kompiliert, minimiert und in die Warteschlange eingereiht.
- Assets registrieren: Dateinamenskonventionen und Verhalten beim Einreihen in die Warteschlange
- Verarbeitung:SCSS-Kompilierung, ES-Modul-Imports und Minimierung
- Codefeld: Code direkt über den Feldtyp Codefeld bearbeiten
Assets eines Blocks prüfen
bs_block_assets('theme/card') gibt die ermittelten Frontend- und Editor-Canvas-Assets eines registrierten Blockstudio-Blocks zurück. Rufe die Funktion nach der Blockregistrierung auf, ab init. Unbekannte Blöcke, Nicht-Blockstudio-Blöcke und Blöcke ohne Assets geben [] zurück. Der Helfer rendert den Block nicht, reiht nichts in die Warteschlange ein und löst keine Kompilierung aus.
$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 ...>',
];
typeiststylefür CSS undmodulefür JavaScript. Die dateibasierten JavaScript-Assets von Blockstudio verwenden ES-Module, einschließlich Inline-Skripten.handleist die stabile Asset-Kennung, die der Renderer von Blockstudio und der Filterblockstudio/assets/disableverwenden. Sie muss nicht in WordPress eingereiht werden.urlist die aufgelöste URL des vorhandenen kompilierten Assets einschließlich seiner Version oder die Quell-URL, wenn keine kompilierte Datei vorhanden ist. Bei Inline-Assets ist sienull.inlineunterscheidet Inline-<style>/<script>-Ausgabe von externen Dateien.scopeführt die Kontexte auf, in denen das Asset gilt:frontendundeditorbei gemeinsam genutzten Dateien und nur einen bei View- und Editor-Dateien.htmlenthält das sofort verwendbare Tag des regulären Asset-Renderers. Inline-Inhalte, bereichsbezogenes CSS, UI-Stilebenen und Deaktivierungsfilter zur Renderzeit werden wie bei der gewöhnlichen Blockausgabe behandelt.
Fehlende, leere, deaktivierte und nicht kompilierte SCSS Dateien werden ausgelassen. WordPress-eingereihte Admin- und Block-Editor-Assets des übergeordneten Dokuments sind ausgeschlossen. Die Liste ist auf die entdeckten Dateien des Blocks selbst beschränkt. Sie bildet keine vollständige Abhängigkeitsauflösung ab: Verschachtelte Blöcke, Werte von Code-Feldern, mit WordPress eingereihte Handles, CSS-Imports, Tailwind sowie gemeinsam genutzte UI-/Interactivity-Runtimes können vom gerenderten Inhalt abhängen. Verwende Render::document() für eine vollständige, eigenständige Vorschau. Verwende bs_block_fields(), um die registrierten Felddefinitionen zu prüfen.