• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/next image link

提供: WordPress Codex 日本語版
移動先: 案内検索

現在の投稿に添付された次の画像へのリンクを表示します。添付ファイルのページに一連の画像がリンクされているときはいつでも、添付ファイルのページに画像と一緒に「次の画像へのリンク」を表示します。

使い方

典型的には attachment.php 内で使います。WordPress デフォルトテーマの Twenty Eleven と Twenty Twelve では、image.php 内で使われています。

<?php next_image_link( $size, $text ); ?>

パラメータ

$size
文字列) (オプション) 画像のサイズを配列または文字列で指定。0 または none を指定するとリンクテキストが post_title(添付ファイルのタイトル)または $text になります。
初期値: 'thumbnail'
$text
文字列) (オプション) 指定すると、リンクテキストが $text の値になります。
初期値: false - 指定なし

戻り値

(void) 
何も返しません。

用例

デフォルトの使い方

<?php next_image_link(); ?>

実用的な例

<div class="alignright"><?php next_image_link(); ?></div>

変更履歴

  • 新規導入: 2.5.0
  • 2.8 で、2つのパラメータを追加: $size と $text

ソースファイル

next_image_link()wp-includes/media.php にあります。


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/next_image_link最新版との差分