get_adjacent_image_link()


WordPressのget_adjacent_image_link()関数は、現在の画像に対して前後の画像へのリンクを取得するために使用されます。この関数は、ギャラリー内でのナビゲーションに役立ちます。

構文

get_adjacent_image_link( bool $prev = true, string $size = 'thumbnail', bool $text = false );

引数の説明:

  • $prev(bool) — 前の画像へのリンクを取得する場合はtrue、次の画像へのリンクを取得する場合はfalse。
  • $size(string) — 画像のサイズを指定します。デフォルトは'thumbnail'。
  • $text(bool) — リンクテキストを表示する場合はtrue、画像を表示する場合はfalse。

例1: 前の画像へのリンクを取得

この例では、現在の画像の前の画像へのリンクを取得します。

<?php echo get_adjacent_image_link(true); ?>

例2: 次の画像へのリンクを取得

この例では、現在の画像の次の画像へのリンクを取得します。

<?php echo get_adjacent_image_link(false); ?>

例3: カスタムサイズの画像リンクを取得

この例では、'medium'サイズの画像リンクを取得します。

<?php echo get_adjacent_image_link(true, 'medium'); ?>

例4: リンクテキストを表示

この例では、画像の代わりにリンクテキストを表示します。

<?php echo get_adjacent_image_link(true, 'thumbnail', true); ?>

例5: 次の画像のリンクテキストを表示

この例では、次の画像へのリンクテキストを表示します。

<?php echo get_adjacent_image_link(false, 'thumbnail', true); ?>

例6: カスタムテキスト付きのリンクを表示

この例では、カスタムテキスト付きのリンクを表示します。

<?php echo get_adjacent_image_link(true, 'thumbnail', '前の画像'); ?>

例7: 次の画像のカスタムテキスト付きリンクを表示

この例では、次の画像へのカスタムテキスト付きリンクを表示します。

<?php echo get_adjacent_image_link(false, 'thumbnail', '次の画像'); ?>

注意点

  • この関数は、画像がギャラリー内に存在する場合にのみ機能します。
  • 指定したサイズの画像が存在しない場合、デフォルトのサイズが使用されます。
  • リンクテキストを表示する場合、画像は表示されません。

関連機能：