get_posts_nav_link()


WordPressのget_posts_nav_link()関数は、投稿のナビゲーションリンクを取得するために使用されます。この関数は、前後の投稿へのリンクを生成し、ページネーションを簡単に実装するために役立ちます。

構文

get_posts_nav_link( array $args = array() );

引数の説明:

  • $args(array) — ナビゲーションリンクの設定を指定するための配列。以下のキーを使用できます:
    • 'sep'(string) — リンク間の区切り文字。デフォルトは' — '。
    • 'prelabel'(string) — 「前へ」リンクのテキスト。デフォルトは'Previous Page'。
    • 'nxtlabel'(string) — 「次へ」リンクのテキスト。デフォルトは'Next Page'。

例1: 基本的な使用例

ナビゲーションリンクを表示する最もシンプルな例です。

<?php echo get_posts_nav_link(); ?>

例2: カスタム区切り文字の使用

リンク間の区切り文字をカスタマイズします。

<?php echo get_posts_nav_link( array( 'sep' => ' | ' ) ); ?>

例3: カスタムラベルの設定

「前へ」と「次へ」のリンクテキストを変更します。

<?php echo get_posts_nav_link( array( 'prelabel' => '前の投稿', 'nxtlabel' => '次の投稿' ) ); ?>

例4: 区切り文字なしで表示

区切り文字なしでナビゲーションリンクを表示します。

<?php echo get_posts_nav_link( array( 'sep' => '' ) ); ?>

例5: カスタムクラスの追加

ナビゲーションリンクにカスタムクラスを追加します。

<?php echo '<div class="custom-nav">' . get_posts_nav_link() . '</div>'; ?>

例6: 条件付きでナビゲーションを表示

投稿が複数ある場合にのみナビゲーションリンクを表示します。

<?php if ( get_previous_posts_link() || get_next_posts_link() ) { echo get_posts_nav_link(); } ?>

注意点

  • この関数は、メインクエリに基づいてナビゲーションリンクを生成します。カスタムクエリを使用する場合は、適切な関数を選択してください。
  • 区切り文字やラベルをカスタマイズする際は、HTMLエスケープに注意してください。

関連機能：