メディア
テーマ画像はメディアライブラリの外にあるため、WordPressは画像サイズを把握できず、スタイル未適用の画像が読み込まれるたびにレイアウトがずれます。Blockstudioは、生成したメタデータマニフェスト、実際のサイズを常に出力するテンプレートヘルパー、任意で使える遅延ローダーでこの問題を解決します。
画像のレンダリング
bs_media_image()はテーマアセットを、実際の幅と高さ、および確保されたアスペクト比とともにレンダリングします。
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
出力はfigure.blockstudio-mediaであり、実際のwidth、height、loading、decoding値を持つimgの周囲にインラインaspect-ratioが配置されます。
srcにはテーマ相対パス、絶対パス、または完全なURLを指定でき、attachmentIdはメディアライブラリの画像に対応します。eagerはファーストビューでの遅延読み込みを無効にし、sourcesは指定した代替候補を持つ<picture>要素を出力します。
メタデータがある場合、ヘルパーは既知の幅、高さ、アスペクト比の値を必ず出力します。遅延読み込みモードでは、blockstudio-*のクラス、属性、ハンドル、グローバルのみを使います。
メタデータマニフェスト
サイズ情報はassets/media.jsonから取得します。ビルド手順でBlockstudio\Media_Metadata_Builderを実行するか、手動で記述します。
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
テーマのアセットのメタデータを決定的に書き込み、第2引数を指定すると任意のWordPress添付ファイルも含めます。assets/以下のファイルを変更するたびに再生成してください。
Media_Metadata_Builder::build( string $root )はマニフェストを返しますが、書き込みは行いません。write()は保存するバリアントです。Blockstudio\Media_Metadata::reset()は再構築後にプロセス内キャッシュを消去します。新しいメタデータを使ってレンダリングする前に、長時間稼働するビルドプロセスで必要になります。
遅延読み込み
performance.media設定がフロントエンドローダーを制御します。
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
lazyを有効にすると、実際のURLは適切なサイズのプレースホルダーの背後でdata-srcに移動します。画像がビューポートに近づくと、Blockstudioの交差判定ベースのローダーが画像を切り替え、rootMarginで事前に読み込みます。skeletonは組み込みの読み込み用プレースホルダーを表示し、metadataはassets/media.jsonが使用中であることを宣言します。
speedとstrictのパフォーマンスプロファイルではローダーがデフォルトで有効になり、compatでは無効です。子の各値でプロファイルのデフォルトを上書きできます。
performance.mediaの全オプション一覧。
メディアメタデータは、本番環境への導入手順の2番目です。