WordPress 原生帖子分頁頁碼 – 最簡單方法 the_posts_pagination()

the_posts_pagination( array $args = array() )

get_the_posts_pagination( array $args = array() )

基本上這兩個 function 是一樣的東西，只是一個是顯示出來，一個是回傳字串而已，都用在取得分頁頁碼，這兩個 function 的優點是使用非常簡單，依文章下方輸出的HTML格式套上CSS，帖子列表的分頁頁碼就實現了。

預設參數：

<?php 
$args = array(
    'mid_size'           => 1,
    'prev_text'          => _x( 'Previous', 'previous set of posts' ),
    'next_text'          => _x( 'Next', 'next set of posts' ),
    'screen_reader_text' => __( 'Posts navigation' ),
);
?>

• mid_size（ int） – 要顯示到當前頁面兩側的頁碼數。默認為 1。
• prev_text（ string） – 上一則帖子的鏈接的文字。默認為”Previous”。
• next_text（ string） – 下一則帖子的鏈接的文字。默認為”Next”。
• screen_reader_text（ string） – 用於屏幕閱讀器的文本。默認為”Posts navigation”。

範例：

這兩個 function 只差在 get_the_posts_pagination() 要用 echo 來輸出字串，其他完全一樣

<?php

the_posts_pagination();

echo get_the_posts_pagination();

?>

輸出：

<nav class="navigation pagination" role="navigation">
  <h2 class="screen-reader-text">Posts navigation</h2>
  <div class="nav-links">
  <span class='page-numbers current'>1</span>
  <a class='page-numbers' href='http://locahost/page/2/'>2</a>
  <a class='page-numbers' href='http://locahost/page/3/'>3</a>
  <a class='page-numbers' href='http://locahost/page/4/'>4</a>
  <a class="next page-numbers" href="http://locahost/page/5/">Next</a>
  </div>
</nav>