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>

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

這個網站採用 Akismet 服務減少垃圾留言。進一步瞭解 Akismet 如何處理網站訪客的留言資料