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

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

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

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

この項目「テンプレートタグ/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 PageNext 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>

外部リソース

変更履歴

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最新版との差分