- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
テンプレートタグ/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 以降のデフォルトは '« Previous Page'
- $nextlabel
- (文字列) 次のページへのリンクとして出力する記号やテキスト。
- 1.2.x のデフォルトは 'Next Page >>'
- 1.5 以降のデフォルトは 'Next Page »'
用例
デフォルトの使い方
デフォルトの posts_nav_link() はこのように表示します。
<?php posts_nav_link(); ?>
DIV タグで中央に配置
ひとつ前と次のページへのリンク("previous page · next page")をページの中央に表示します。
<div style="text-align:center;">; <?php posts_nav_link( ' · ', '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( '', '', '« Previous Entries' ); ?></div> <div class="alignright"><?php posts_nav_link( '', 'Next Entries »', '' ); ?></div> </div>
こっちが良いコードです:
<div class="navigation"> <div class="alignleft"><?php previous_posts_link( '« Previous Entries' ); ?></div> <div class="alignright"><?php next_posts_link( 'Next Entries »', '' ); ?></div> </div>
リンクのテキストを変更
各リンクのテキストとリンク間のテキストを変更できます。
<p><?php posts_nav_link( ' or ', 'You can go back to the previous page', 'you can go forward to the next page' ); ?>.</p>
外部リソース
変更履歴
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 (最新版との差分)