Zum Inhalt springen

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.

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 ist style für CSS und module für JavaScript. Die dateibasierten JavaScript-Assets von Blockstudio verwenden ES-Module, einschließlich Inline-Skripten.
  • handle ist die stabile Asset-Kennung, die der Renderer von Blockstudio und der Filter blockstudio/assets/disable verwenden. Sie muss nicht in WordPress eingereiht werden.
  • url ist 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 sie null.
  • inline unterscheidet Inline-<style>/<script>-Ausgabe von externen Dateien.
  • scope führt die Kontexte auf, in denen das Asset gilt: frontend und editor bei gemeinsam genutzten Dateien und nur einen bei View- und Editor-Dateien.
  • html enthä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.