wp_lazy_loading_enabled()


WordPressのwp_lazy_loading_enabled()関数は、遅延読み込みが有効かどうかを判定するために使用されます。主に画像やiframeなどのリソースの読み込みを最適化する際に利用されます。

構文

wp_lazy_loading_enabled( string $tag_name, string $context );

引数の説明:

  • $tag_name (string) — 遅延読み込みをチェックするHTMLタグ名（例: ‘img’, ‘iframe’）
  • $context (string) — コンテキスト（例: ‘the_content’, ‘the_post_thumbnail’）

例1: 画像の遅延読み込みを確認

投稿内の画像に遅延読み込みが有効かどうかをチェックします。

if (wp_lazy_loading_enabled('img', 'the_content')) { echo '遅延読み込み有効'; }

例2: iframeの遅延読み込みを無効化

特定のコンテキストでiframeの遅延読み込みを無効にします。

add_filter('wp_lazy_loading_enabled', function($enabled, $tag_name, $context) { return 'iframe' === $tag_name ? false : $enabled; }, 10, 3);

例3: カスタムタグの遅延読み込みを確認

カスタムHTMLタグに対して遅延読み込みをチェックします。

wp_lazy_loading_enabled('custom-tag', 'custom_context');

例4: サムネイル画像の遅延読み込みを判定

投稿サムネイルの遅延読み込みが有効かどうかを確認します。

if (wp_lazy_loading_enabled('img', 'the_post_thumbnail')) { // 処理 }

例5: 特定のコンテキストでのみ遅延読み込みを無効化

‘the_content’コンテキストでのみ遅延読み込みを無効にします。

add_filter('wp_lazy_loading_enabled', function($enabled, $tag_name, $context) { return 'the_content' === $context ? false : $enabled; }, 10, 3);

例6: 全ての遅延読み込みを無効化

全てのタグとコンテキストで遅延読み込みを無効にします。

add_filter('wp_lazy_loading_enabled', '__return_false');

例7: 特定のタグでのみ遅延読み込みを有効化

‘img’タグのみ遅延読み込みを有効にします。

add_filter('wp_lazy_loading_enabled', function($enabled, $tag_name) { return 'img' === $tag_name; }, 10, 2);

注意点:

  • この関数はWordPress 5.5以降で利用可能です。
  • フィルターフックを使用して挙動を変更できます。
  • パフォーマンスに影響する可能性があるため、慎重に使用してください。

関連機能：