[WordPress] 替文章列表增添分頁按鈕- the_posts_pagination()

在 WordPress 裡要替文章列表增加分頁按鈕，可以直接使用 the_posts_pagination() 這個函式。

完整參數：

the_posts_pagination( array $args = array() )

可以帶入的參數有這些：

$args

(array) (Optional) Default pagination arguments, see paginate_links().

• 'screen_reader_text'
  (string) Screen reader text for navigation element. Default 'Posts navigation'.
• 'aria_label'
  (string) ARIA label text for the nav element. Default 'Posts'.
• 'class'
  (string) Custom class for the nav element. Default 'pagination'.

 

Default value: array()

要修改自動生成分頁的一些資訊，可以參考 paginate_links() 帶入參數的設定：

$args

(string|array) (Optional) Array or string of arguments for generating paginated links for archives.

• 'base'
  (string) Base of the paginated url.
• 'format'
  (string) Format for the pagination structure.
• 'total'
  (int) The total amount of pages. Default is the value WP_Query's max_num_pages or 1.
• 'current'
  (int) The current page number. Default is 'paged' query var or 1.
• 'aria_current'
  (string) The value for the aria-current attribute. Possible values are 'page', 'step', 'location', 'date', 'time', 'true', 'false'. Default is 'page'.
• 'show_all'
  (bool) Whether to show all pages. Default false.
• 'end_size'
  (int) How many numbers on either the start and the end list edges. Default 1.
• 'mid_size'
  (int) How many numbers to either side of the current pages. Default 2.
• 'prev_next'
  (bool) Whether to include the previous and next links in the list. Default true.
• 'prev_text'
  (bool) The previous page text. Default '« Previous'.
• 'next_text'
  (bool) The next page text. Default 'Next »'.
• 'type'
  (string) Controls format of the returned value. Possible values are 'plain', 'array' and 'list'. Default is 'plain'.
• 'add_args'
  (array) An array of query args to add. Default false.
• 'add_fragment'
  (string) A string to append to each link.
• 'before_page_number'
  (string) A string to appear before the page number.
• 'after_page_number'
  (string) A string to append after the page number.

 

Default value: ''

參考：
the_posts_pagination()