previous_comments_link()


WordPressの関数previous_comments_link()は、現在表示されているページよりも前のコメントページへのリンクを生成します。この関数は主にカスタムコメントテンプレートを作成するときに使用されます。

シンタックス

<?php previous_comments_link( string $label = null, int $max_page = 0 ); ?>

引数の説明:

  • $label (string) — リンクテキスト。デフォルトでは「« Previous Comments」になります。
  • $max_page (int) — 最大ページ数を指定します。デフォルトは0で、無制限です。

例 1: 基本的な使用例

現在のコメントページより前のページへのリンクを表示します。

<?php previous_comments_link(); ?>

例 2: カスタムリンクテキストを設定する

リンクテキストを「前のコメント」に変更します。

<?php previous_comments_link( '前のコメント' ); ?>

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

最大3ページまでリンクを表示します。

<?php previous_comments_link( '前のコメント', 3 ); ?>

例 4: 条件付きでリンクを表示する

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

<?php
if ( get_previous_comments_link() ) {
    previous_comments_link( '前のコメント' );
}
?>

例 5: カスタムHTMLタグでリンクをラップする

リンクを特定のHTML要素でラップします。

<?php
if ( get_previous_comments_link() ) {
    echo '<div class="custom-link">';
    previous_comments_link( '前のコメント' );
    echo '</div>';
}
?>

注意点

  • previous_comments_link()はコメントがページ分割されている場合にのみ動作します。
  • テーマテンプレート内で使用する際は、コメントが有効であることを確認してください。

関連機能：