the_posts_navigation

（4.1.0以降）
the_posts_navigation - アーカイブページ向けのナビゲーションを表示する

説明

void the_posts_navigation( [ array $args = array() ] )
アーカイブページ向けのナビゲーションを表示する。

パラメータ

  • $args
    パラメータを連想配列で指定（省略時はarray()）。
    キー意味省略時の値
    'prev_text'前ページリンクの表記'Previous'
    'next_text'次ページリンクの表記'Next'
    'screen_reader_text'ナビゲーションの見出し（h2タグの中身）__( 'Posts navigation' )

返り値

返り値はありません。

注意

ナビゲーションの中身は get_the_posts_navigation関数を呼び出して取得。なお表示されるナビゲーションはnavタグを使用している。

ページ番号を含んだナビゲーションを表示する the_posts_pagination関数もある。

使用例

  • アーカイブページ向けのナビゲーションを表示する。
    <?php the_posts_navigation(); ?>
  • アーカイブページ向けのナビゲーションをリンク表記を指定して表示する。
    <?php the_posts_navigation( array( 'prev_text' => '前へ', 'next_text' => '次へ' ) ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

最終更新 : 2019年09月25日 20:16

関連

参考

Code Reference: the_posts_navigation

お勧め

Posts filter multiselect：プラグイン作ってみました（2022年4月8日 更新）

先週の金曜日、知り合いの方から「投稿一覧ページで絞り込みを行う際、複数選択できないか」といった問い合わせがあり、その時には「標準では無理ですね」と返答しました。このこと自体は事実なのですが、要するに「複数選択可能なドロップダウンメニュー」が実現できれば対応するのはそれほど難しくないような気がしました。この週末、そんなノリでちょっとコーディングしてできたのがこのプラグインです。

全投稿を取得するのはnopaging=1でいい（2011年8月31日 更新）

query_posts関数（またはWP_Queryクラス）を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」－「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには？

Contact Form 7に確認フェーズを（2012年12月16日 更新）

Contact Form 7はWordPressによるサイト製作でお世話になることが多いプラグインの1つ。ただ、クライアント様によっては、入力、確認、送信の3フェーズにしたいという要望があり、そんな時は別の方法を採用していたのですが、JavaScript（jQuery）を使ってページ遷移しなくてもいいなら確認フェーズは用意できるかなと思い、作り込んでみた。

古めのリビジョンを削除した時のメモ（2022年5月16日 更新）

大きく育ったデータベースを整理するため、古めのリビジョンとそれに紐づいたカスタムフィールドデータを削除。と思ったら「The total number of locks exceeds the lock table size」というエラーが発生して削除できなかった。

プラグインで注意が必要な関数（2013年11月27日 更新）

先日「Login rebuilder」という自作プラグインをアップデートした際、ユーザーさんからエラーになると連絡をいただいた。標準環境では問題なく、どうやら何らかのプラグインが影響しているらしい。