在 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()