get_next_posts_link() の説明と使用例

WordPressのget_next_posts_link()関数は、現在のページの次のページへのリンクを生成するために使用されます。この関数は、ページネーションを実装する際に役立ちます。

構文

get_next_posts_link( string $label = null, int $max_page = 0 );

引数の説明:

$label (string) — リンクに表示されるテキスト。デフォルトは「次のページ」です。
$max_page (int) — 最大ページ数。デフォルトは0で、すべてのページを対象とします。

例1: 基本的な使用例

次のページへのリンクを表示します。

<?php echo get_next_posts_link(); ?>

例2: カスタムラベルを使用

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

<?php echo get_next_posts_link( '次へ' ); ?>

例3: 最大ページ数を指定

最大ページ数を5に制限します。

<?php echo get_next_posts_link( '次へ', 5 ); ?>

例4: リンクのクラスを追加

リンクにクラスを追加してスタイルを適用します。

<?php echo get_next_posts_link( '次へ', 0 ); ?>
<style>.nav-links a { color: red; }</style>

例5: 条件付きでリンクを表示

次のページが存在する場合のみリンクを表示します。

<?php if ( get_next_posts_link() ) { echo get_next_posts_link( '次へ' ); } ?>

例6: カスタムクエリでの使用

カスタムクエリを使用して次のページへのリンクを生成します。

<?php
$custom_query = new WP_Query( array( 'posts_per_page' => 5 ) );
if ( $custom_query->have_posts() ) {
    while ( $custom_query->have_posts() ) {
        $custom_query->the_post();
        the_title();
    }
    echo get_next_posts_link( '次へ', $custom_query->max_num_pages );
}
wp_reset_postdata();
?>

注意点

get_next_posts_link()は、ページネーションが有効な場合にのみ機能します。
カスタムクエリを使用する場合は、wp_reset_postdata()を忘れずに呼び出してください。

構文