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

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

関数リファレンス/the posts pagination

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

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

投稿ページネーション関数は投稿の前と次のページへリンクするページ番号のセットを出力します。投稿リスト(index.php など)やアーカイブ(archive.php など)で使われます。

この関数は get_the_posts_pagination() の戻り値を表示(echo)します。

使い方

<?php the_posts_pagination( $args ); ?>

パラメータ

$args
配列) (オプション) 省略可能な引数の配列。
初期値: 以下を参照。
  • mid_size (整数) - 現在のページの左右にそれぞれ表示するページ番号の数。デフォルトは1。
  • prev_text (文字列) - 投稿の前のセットへのリンクテキスト。デフォルトは「Previous」。
  • next_text (文字列) - 投稿の次のセットへのリンクテキスト。デフォルトは「Next」。
  • screen_reader_text (文字列) - スクリーンリーダー用テキスト。デフォルトは「Posts navigation」。

用例

<?php the_posts_pagination( array( 'mid_size' => 2 ) ); ?>

前と次のリンクテキストを変えてページ送りを表示

<?php the_posts_pagination( array(
	'mid_size' => 2,
	'prev_text' => __( 'Back', 'textdomain' ),
	'next_text' => __( 'Onward', 'textdomain' ),
) ); ?>

変更履歴

ページネーション: 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/the_posts_pagination最新版との差分