render_block_core_query_pagination_numbers()


WordPressのrender_block_core_query_pagination_numbers()関数は、クエリベースのページネーション番号をレンダリングするために使用されます。この関数は、ブロックエディタ内でページネーションを表示する際に役立ちます。

構文

render_block_core_query_pagination_numbers( array $args );

引数の説明:

  • $args(array) — ページネーションの設定を含む配列。以下のキーを持つことができます:
    • 'total'(int) — 総ページ数。
    • 'current'(int) — 現在のページ番号。
    • 'prev_next'(bool) — 前後のページへのリンクを表示するかどうか。
    • 'before_page_number'(string) — ページ番号の前に表示するテキスト。
    • 'after_page_number'(string) — ページ番号の後に表示するテキスト。

例1: 基本的なページネーションの表示

この例では、基本的なページネーション番号を表示します。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2 ) );

例2: 前後のリンクを含むページネーション

前後のリンクを含むページネーションを表示します。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2, 'prev_next' => true ) );

例3: ページ番号の前後にテキストを追加

ページ番号の前後にカスタムテキストを追加します。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2, 'before_page_number' => 'Page ', 'after_page_number' => ' of 5' ) );

例4: 現在のページを強調表示

現在のページ番号を強調表示するためにカスタムクラスを追加します。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2, 'before_page_number' => '<span class="current">', 'after_page_number' => '</span>' ) );

例5: ページネーションのスタイルをカスタマイズ

CSSクラスを追加してページネーションのスタイルをカスタマイズします。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2, 'before_page_number' => '<span class="custom-pagination">', 'after_page_number' => '</span>' ) );

例6: ページネーションのリンクを無効化

現在のページのリンクを無効化します。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2, 'prev_next' => false ) );

例7: ページネーションのHTML構造を変更

ページネーションのHTML構造をカスタマイズします。

echo render_block_core_query_pagination_numbers( array( 'total' => 5, 'current' => 2, 'before_page_number' => '<li>', 'after_page_number' => '</li>' ) );

注意点

  • この関数は、ブロックエディタ内での使用を前提としています。
  • 引数の配列に不正な値が含まれている場合、予期しない動作が発生する可能性があります。
  • CSSでスタイルを適用する際は、適切なクラス名を使用してください。

関連機能：