get_the_posts_navigation()


関数 WordPressget_the_posts_navigation()は、現在の投稿クエリに基づいて投稿のナビゲーションリンクを表示するために使用されます。

構文

get_the_posts_navigation( array $args = array() );

引数の説明:

  • $args (array) — 関数の動作を制御するためのオプションパラメータを含む連想配列。

主要な配列キー:

  • prev_text (string) — 「前のページ」のリンクテキストを指定します。
  • next_text (string) — 「次のページ」のリンクテキストを指定します。
  • screen_reader_text (string) — スクリーンリーダー向けのテキストを指定します。

例 1: 基本的な投稿ナビゲーションの表示

現在の投稿クエリに基づいて前後の投稿ナビゲーションリンクを表示します。

<?php get_the_posts_navigation(); ?>

例 2: カスタムリンクテキストの使用

「前のページ」および「次のページ」のリンクテキストをカスタマイズする例です。

<?php
get_the_posts_navigation( array(
    'prev_text' => __( '← 前に戻る', 'textdomain' ),
    'next_text' => __( '次に進む →', 'textdomain' )
) );
?>

例 3: スクリーンリーダーテキストのカスタマイズ

アクセシビリティの向上のためにスクリーンリーダーテキストを設定します。

<?php
get_the_posts_navigation( array(
    'screen_reader_text' => __( '投稿ナビゲーション', 'textdomain' )
) );
?>

例 4: 条件付きナビゲーションの表示

投稿が複数ページにまたがっている場合のみナビゲーションリンクを表示します。

<?php
if ( $GLOBALS['wp_query']->max_num_pages > 1 ) {
    get_the_posts_navigation();
}
?>

例 5: カスタムHTMLでラップ

ナビゲーションリンクを特定のHTMLタグでラップする例です。

<?php
echo '<div class="custom-navigation">';
get_the_posts_navigation();
echo '</div>';
?>

関連機能：