paginate_links()
ページナビゲーションリンクを作成する。
the_posts_pagination() と同様の機能だが、WP_Query() で出力した場合などは表示されないため、paginate_links() で表示できる。
<?php // 例 ... the_posts_pagination()での出力と同じにしてみる
echo '<nav class="navigation pagination">'
.'<div class="nav-links">'
.paginate_links([
'format' => '?pg=%#%',
'current' => $e['paged'],
'total' => $max_page
])
.'</div></nav>';| オプション | 初期値 | 備考 |
|---|---|---|
| base | ‘%_%’ | ??使い道がわからん |
| format | ‘?page=%#%’ | |
| total | 1 | 全体のページ数。 |
| current | 0 | 現在のページ番号 |
| prev_text | __(‘&laquo; Previous’) | |
| next_text | __(‘Next &raquo;’) | |
| mid_size | 2 | 現在のページの左右のボタン数 |
| end_size | 1 | 最初と最後のボタン数 |
| add_fragment | null | リンク url に追加する文字列 |
| before_page_number | null | ページ番号テキストの前に追加する文字列 |
| after_page_number | null | ページ番号テキストの後に追加する文字列 |