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

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

関数リファレンス/get previous posts link

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

この項目「関数リファレンス/get previous posts link」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

現在のクエリ内で、投稿のひとつ前のセットへのリンクを取得します。

投稿クエリは日付の逆順にソートされるのが普通です。そのため通常は、get_next_posts_link() が古い投稿(セットの終わり方向)を指し、get_previous_posts_link() が新しい投稿(セットの始まり方向)を指します。

使い方

<?php get_previous_posts_link( $label ); ?>

パラメータ

$label
文字列) (オプション) リンクのテキスト。
初期値: '&laquo; Previous Page'

戻り値

(文字列) 
ひとつ前のページへのリンク(HTML 形式)。何か異常があれば null を返す。

用例

デフォルトの使い方

<?php
    $prev = get_previous_posts_link();
    echo $prev;
?>

変更履歴

2.7 : 新規導入

ソースファイル

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