コンテンツへスキップ

アセット

Blockstudioはブロック向けの設定不要なアセットパイプラインを提供します。ブロックの隣にCSS、SCSS、またはJavaScriptファイルを置くだけで、自動的にコンパイル、圧縮され、読み込まれます。

ブロックのアセットを調べる

bs_block_assets('theme/card')は、登録済みのBlockstudioブロックで検出されたフロントエンドおよびエディターキャンバスのアセットを返します。ブロック登録後、init以降に呼び出してください。不明なブロック、Blockstudioではないブロック、アセットのないブロックの場合は[]を返します。このヘルパーはブロックをレンダリングせず、何もエンキューせず、コンパイルも実行しません。

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はCSSではstyle、JavaScriptではmoduleです。BlockstudioのファイルベースのJavaScriptアセットは、インラインスクリプトを含め、ESモジュールを使用します。
  • handleは、Blockstudioのレンダラーとblockstudio/assets/disableフィルターが使用する安定したアセット識別子です。WordPressでエンキューする必要はありません。
  • urlは、バージョンを含む既存のコンパイル済みアセットの解決済みURL、またはコンパイル済みファイルがない場合のソースURLです。インラインアセットの場合はnullです。
  • inlineは、インラインの<style>/<script>出力と外部ファイルを区別します。
  • scopeには、アセットが適用されるコンテキストが記載されます。共有ファイルではfrontendとeditor、view/editorファイルではそのどちらか一方です。
  • htmlには、通常のアセットレンダラーが生成する、そのまま使用できるタグが含まれます。インラインコンテンツ、スコープ付きCSS、UIスタイルレイヤー、レンダリング時の無効化フィルターは、通常のブロック出力と同じように処理されます。

不足、空、無効、未コンパイルのSCSSファイルは省略されます。WordPressによってエンキューされた管理画面とブロックエディターの親ドキュメントのアセットは除外されます。リストは、そのブロックで検出されたファイルのみを対象とします。依存関係を網羅するものではありません。ネストされたブロック、コードフィールドの値、WordPressによってエンキューされたハンドル、モジュールのCSSインポート、Tailwind、共有のUI/Interactivityランタイムは、レンダリングされたコンテンツに依存する場合があります。完全に自己完結したプレビューにはRender::document()を使用してください。登録済みフィールドの定義を調べるにはbs_block_fields()を使用してください。