説明
void the_posts_pagination( [ array $args = array() ] )
アーカイブページ向けのページ番号ナビゲーションを表示する。
パラメータ
- $argsパラメータを連想配列で指定（省略時はarray()）。
キー 意味 省略時の値 'mid_size' 現在のページ部の表示件数 1 'prev_text' 前ページリンクの表記 'Previous' 'next_text' 次ページリンクの表記 'Next' 'screen_reader_text' ナビゲーションの見出し（h2タグの中身） __( 'Posts navigation' )
返り値
返り値はありません。注意
ナビゲーションの中身は get_the_posts_pagination関数を呼び出して取得。なお表示されるナビゲーションはnavタグを使用している。
新テーマのTwentyFifteenのスタイルでは、'prev_text'と'next_text'で指定した表記は非表示となっている。
単純に前ページおよび次ページのナビゲーションを表示する the_posts_navigation関数もある。
使用例
- アーカイブページ向けのページ番号ナビゲーションを表示する。<?php the_posts_pagination(); ?>
- アーカイブページ向けのページ番号ナビゲーションを'mid_size'を3として表示する。<?php the_posts_pagination( array( 'mid_size' => 3 ) ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/link-template.php最終更新 : 2018年05月27日 10:46
関連
お勧め
個人データのエクスポートメール向けに追加された新フィルター（2020年4月2日 更新）
先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。
決まった値を返すだけの関数群（2018年5月27日 更新）
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。
サイドバーの初期化はwidgets_initアクションで（2011年7月14日 更新）
ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。Gutenbergでカスタムフィールドを使う（2018年8月10日 更新）
Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。
favicon.icoがWordPressロゴになる！？（2020年2月25日 更新）
先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。