[WordPress] 取得文章列表分頁導覽列- get_the_posts_pagination()

要取得 WordPress 文章列表的分頁導覽列，可以使用 get_the_posts_pagination() 這個函式。

$pagination=get_the_posts_pagination();
echo $pagination;
 

該函式會回傳一個 HTML 的字串，預設大概會長這樣：

<nav class="navigation " aria-label="文章">
  <h2 class="screen-reader-text">文章導覽</h2>
  <div class="nav-links">
    <a class="prev page-numbers" href="[domain]/category/[category_type]/page/1/">上一頁</a>
    <a class="page-numbers" href="[domain]/category/[category_type]/page/1/">1</a>
    <span aria-current="page" class="page-numbers current">2</span>
    <a class="page-numbers" href="[domain]/category/[category_type]/page/3/">3</a>
    <a class="next page-numbers" href="[domain]/category/[category_type]/page/3/">下一頁  </a>
  </div>
</nav>	

會自動判斷如果文章不夠可以分頁就不會出現，如果沒有上一頁或下一頁也不會有連結的內容。

函式可以帶入參數，像是：

$args=[
  "class"=>"custom-clasname", //自訂的 navigation 那一層的 class name
  "screen_reader_text" => "",  //修改 screen-reader-text 那一個標籤內的文字
];
$pagination=get_the_posts_pagination($args);

大概比較常用的就是 class 那一個，其他設定的內容可以參考官方文件說明：
get_the_posts_pagination()