block_core_image_print_lightbox_overlay()


WordPressのblock_core_image_print_lightbox_overlay()関数は、画像ブロックにライトボックスオーバーレイを表示するために使用されます。この関数は、画像がクリックされたときにライトボックスを表示するためのHTMLを生成します。

構文

block_core_image_print_lightbox_overlay( string $image_id, string $image_url );

引数の説明:

  • $image_id(string) — 画像のIDを指定します。
  • $image_url(string) — 画像のURLを指定します。

例1: 基本的な使用例

画像IDとURLを指定してライトボックスオーバーレイを表示します。

<?php block_core_image_print_lightbox_overlay( get_post_thumbnail_id(), wp_get_attachment_url( get_post_thumbnail_id() ) ); ?>

例2: カスタム画像を使用する

カスタム画像のIDとURLを指定してライトボックスオーバーレイを表示します。

<?php block_core_image_print_lightbox_overlay( 123, 'https://example.com/image.jpg' ); ?>

例3: ループ内での使用

ループ内で各投稿のサムネイルにライトボックスオーバーレイを適用します。

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); block_core_image_print_lightbox_overlay( get_post_thumbnail_id(), wp_get_attachment_url( get_post_thumbnail_id() ) ); endwhile; endif; ?>

例4: 外部画像の使用

外部画像のURLを指定してライトボックスオーバーレイを表示します。

<?php block_core_image_print_lightbox_overlay( null, 'https://external-site.com/image.jpg' ); ?>

例5: 特定の画像サイズを使用

特定の画像サイズのURLを取得してライトボックスオーバーレイを表示します。

<?php block_core_image_print_lightbox_overlay( get_post_thumbnail_id(), wp_get_attachment_image_url( get_post_thumbnail_id(), 'large' ) ); ?>

例6: カスタムフィールドから画像を取得

カスタムフィールドから画像IDとURLを取得してライトボックスオーバーレイを表示します。

<?php $image_id = get_field('custom_image_field'); $image_url = wp_get_attachment_url( $image_id ); block_core_image_print_lightbox_overlay( $image_id, $image_url ); ?>

例7: 複数の画像に適用

複数の画像にライトボックスオーバーレイを適用します。

<?php $images = get_field('gallery'); foreach ( $images as $image ) { block_core_image_print_lightbox_overlay( $image['id'], $image['url'] ); } ?>

例8: 条件付きで表示

特定の条件を満たす場合にのみライトボックスオーバーレイを表示します。

<?php if ( is_single() ) { block_core_image_print_lightbox_overlay( get_post_thumbnail_id(), wp_get_attachment_url( get_post_thumbnail_id() ) ); } ?>

注意点

  • この関数は、画像ブロックが有効な場合にのみ動作します。
  • 画像IDが指定されていない場合、ライトボックス機能が正しく動作しない可能性があります。

関連機能：