テンプレートタグ/posts nav link

この項目「テンプレートタグ/posts nav link」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

説明

次とひとつ前のページへのリンクを一度に表示します。インデックスや月別・カテゴリー別アーカイブページに「ページ送り」ナビゲーションをつけるのに役立ちます。

次と前のページ（投稿セット）へのリンクを別々に表示するには next_posts_link() と previous_posts_link() を見てください。

個別投稿ページで次とひとつ前の投稿へのナビゲーションを表示するには next_post_link() と previous_post_link() を見てください。

使い方

<?php posts_nav_link( $sep, $prelabel, $nextlabel ); ?>

注意: ブログ投稿は日付の逆順（最新の投稿が先頭）に表示されるのが慣例なので、「次のページ」の定義が曖昧になっています。WordPress の定義は「過去へ向かって次のページ」です。WordPress 1.5 のデフォルトテーマ Kubrick は、「次のページ」リンクを「前のエントリー」と表示することで曖昧さに対処しました。用例: Kubrick テーマ形式 を見てください。

パラメータ

$sep 

(文字列) リンクの間に出力する記号やテキスト。

• 1.2.x のデフォルトは ' :: '
• 1.5 以降のデフォルトは ' — '

$prelabel 

(文字列) 前のページへのリンクとして出力する記号やテキスト。

• 1.2.x のデフォルトは '<< Previous Page'
• 1.5 以降のデフォルトは '&laquo; Previous Page'

$nextlabel 

(文字列) 次のページへのリンクとして出力する記号やテキスト。

• 1.2.x のデフォルトは 'Next Page >>'
• 1.5 以降のデフォルトは 'Next Page &raquo;'

用例

デフォルトの使い方

デフォルトの posts_nav_link() はこのように表示します。

« Previous Page — Next Page »

<?php posts_nav_link(); ?>

DIV タグで中央に配置

ひとつ前と次のページへのリンク（"previous page · next page"）をページの中央に表示します。

<div style="text-align:center;">;
<?php posts_nav_link( ' &#183; ', 'previous page', 'next page' ); ?>
</div>

画像を使う

<?php posts_nav_link(
    ' ',
    '<img src="' . get_bloginfo( 'stylesheet_directory' ) . '/images/prev.jpg" />',
    '<img src="' . get_bloginfo( 'stylesheet_directory' ) . '/images/next.jpg" />'
); ?>

Kubrick テーマ形式

Kubrick テーマの投稿ナビゲーション形式は、次のような方法で表示できます。しかし posts_nav_link() をこのように使うと意図しない結果になります。例えば、誤ったセクションへリンクした二段重ねの前・次リンクです。

実際の Kubrick テーマは next_posts_link() と previous_posts_link() を使っています。

このコードはまずいので使ってはいけません：

<div class="navigation">
<div class="alignleft"><?php posts_nav_link( '', '', '&laquo; Previous Entries' ); ?></div>
<div class="alignright"><?php posts_nav_link( '', 'Next Entries &raquo;', '' ); ?></div>
</div>

こっちが良いコードです：

<div class="navigation">
<div class="alignleft"><?php previous_posts_link( '&laquo; Previous Entries' ); ?></div>
<div class="alignright"><?php next_posts_link( 'Next Entries &raquo;', '' ); ?></div>
</div>

リンクのテキストを変更

各リンクのテキストとリンク間のテキストを変更できます。

You can go back to the previous page or you can go forward to the next page.

<p><?php posts_nav_link( ' or ', 'You can go back to the previous page', 'you can go forward to the next page' ); ?>.</p>

外部リソース

• Digging into Wordpress - Definitive Guide to WordPress Page Navigation

変更履歴

2.8.0 : 新規導入

ソースファイル

posts_nav_link() は wp-includes/link-template.php にあります。

関連項目

ページネーション: posts_nav_link(), next_posts_link(), previous_posts_link(), get_next_posts_link(), get_previous_posts_link(), paginate_links(), wp_link_pages(), next_post_link(), previous_post_link(), next_image_link(), previous_image_link(), the_posts_pagination(), get_the_posts_pagination()

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

最新英語版： WordPress Codex » Function Reference/posts_nav_link （最新版との差分）