block_core_gallery_render()


WordPressのblock_core_gallery_render()関数は、ギャラリーブロックのレンダリングを行うために使用されます。この関数は、ギャラリーのHTMLを生成し、フロントエンドに表示します。

構文

block_core_gallery_render( array $attributes, string $content );

引数の説明:

  • $attributes(array) — ギャラリーブロックの属性を指定します。例えば、画像のIDや列数などが含まれます。
  • $content(string) — ブロックのコンテンツを指定します。通常は空ですが、カスタマイズ時に使用されます。

例1: 基本的なギャラリーのレンダリング

この例では、ギャラリーブロックをレンダリングします。

echo block_core_gallery_render( array( 'ids' => array( get_post_thumbnail_id() ), 'columns' => 3 ), '' );

例2: カスタム画像IDを使用したギャラリー

カスタム画像IDを指定してギャラリーを表示します。

echo block_core_gallery_render( array( 'ids' => array( 123, 456, 789 ), 'columns' => 2 ), '' );

例3: 列数を変更したギャラリー

列数を4列に設定してギャラリーを表示します。

echo block_core_gallery_render( array( 'ids' => array( 123, 456, 789 ), 'columns' => 4 ), '' );

例4: リンク先をファイルに設定

画像のリンク先をファイルに設定します。

echo block_core_gallery_render( array( 'ids' => array( 123, 456, 789 ), 'linkTo' => 'file' ), '' );

例5: リンク先をなしに設定

画像のリンク先を無効にします。

echo block_core_gallery_render( array( 'ids' => array( 123, 456, 789 ), 'linkTo' => 'none' ), '' );

例6: カスタムサイズの画像を使用

カスタム画像サイズを使用してギャラリーを表示します。

echo block_core_gallery_render( array( 'ids' => array( 123, 456, 789 ), 'size' => 'medium' ), '' );

例7: ギャラリーにカスタムクラスを追加

ギャラリーにカスタムCSSクラスを追加します。

echo block_core_gallery_render( array( 'ids' => array( 123, 456, 789 ), 'className' => 'custom-gallery' ), '' );

注意点

  • 画像IDが存在しない場合、ギャラリーは正しく表示されません。
  • 列数は1以上である必要があります。
  • リンク先の設定は’none’, ‘file’, ‘post’のいずれかである必要があります。

関連機能：