the_comments_navigation()


WordPressのthe_comments_navigation()関数は、コメントのページネーションを表示するために使用されます。この関数は、コメントが多数ある場合に前後のコメントページへのリンクを提供します。

構文

the_comments_navigation( array $args = array() );

引数の説明:

  • $args(array) — ページネーションの設定をカスタマイズするための引数。デフォルトは空の配列。
  • 'prev_text'(string) — 「前へ」リンクのテキストを指定します。
  • 'next_text'(string) — 「次へ」リンクのテキストを指定します。
  • 'screen_reader_text'(string) — スクリーンリーダー用のテキストを指定します。
  • 'aria_label'(string) — ナビゲーションのARIAラベルを指定します。
  • 'class'(string) — ナビゲーションのCSSクラスを指定します。

例1: 基本的なコメントナビゲーションの表示

この例では、デフォルトの設定でコメントナビゲーションを表示します。

<?php the_comments_navigation(); ?>

例2: 「前へ」と「次へ」のテキストを変更

「前へ」と「次へ」のテキストをカスタマイズして表示します。

<?php the_comments_navigation( array( 'prev_text' => '前のコメント', 'next_text' => '次のコメント' ) ); ?>

例3: スクリーンリーダーテキストの変更

スクリーンリーダー用のテキストを変更します。

<?php the_comments_navigation( array( 'screen_reader_text' => 'コメントナビゲーション' ) ); ?>

例4: ARIAラベルの追加

ARIAラベルを追加してアクセシビリティを向上させます。

<?php the_comments_navigation( array( 'aria_label' => 'コメントページネーション' ) ); ?>

例5: CSSクラスの追加

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

<?php the_comments_navigation( array( 'class' => 'custom-comment-nav' ) ); ?>

例6: 全ての引数を組み合わせる

全ての引数を組み合わせて、完全にカスタマイズされたコメントナビゲーションを表示します。

<?php the_comments_navigation( array( 'prev_text' => '前のコメント', 'next_text' => '次のコメント', 'screen_reader_text' => 'コメントナビゲーション', 'aria_label' => 'コメントページネーション', 'class' => 'custom-comment-nav' ) ); ?>

例7: コメントナビゲーションを条件付きで表示

コメントが存在する場合にのみナビゲーションを表示します。

<?php if ( get_comment_pages_count() > 1 ) { the_comments_navigation(); } ?>

例8: コメントナビゲーションのスタイルを変更

CSSを使用してコメントナビゲーションのスタイルを変更します。

<?php the_comments_navigation( array( 'class' => 'comment-nav-style' ) ); ?>

注意点

  • この関数は、コメントがページネーションされる場合にのみ機能します。
  • カスタマイズする際は、アクセシビリティを考慮してARIAラベルやスクリーンリーダーテキストを適切に設定してください。

関連機能：