get_posts_nav_link

函式
get_posts_nav_link ( $args = array() )
引數
  • (string|array) $args { Optional. Arguments to build the post pages link navigation. @type string $sep Separator character. Default '—'. @type string $prelabel Link text to display for the previous page link. Default '« Previous Page'. @type string $nxtlabel Link text to display for the next page link. Default 'Next Page »'. }
    Required:
    Default: array()
返回值
  • (string) The posts link navigation.
定義位置
相關方法
posts_nav_linknext_posts_linkget_post_format_linkget_post_permalinkget_next_posts_page_link
引入
2.8.0
棄用
-

get_posts_nav_link函式是一個WordPress函式,用於檢索文章導航連結的HTML標記: 這個函式接受一個連結文字的可選引數,並返回文章導航連結的HTML標記。

檢索上一頁和下一頁的文章頁面連結導航。

function get_posts_nav_link( $args = array() ) {
	global $wp_query;

	$return = '';

	if ( ! is_singular() ) {
		$defaults = array(
			'sep'      => ' — ',
			'prelabel' => __( '« Previous Page' ),
			'nxtlabel' => __( 'Next Page »' ),
		);
		$args     = wp_parse_args( $args, $defaults );

		$max_num_pages = $wp_query->max_num_pages;
		$paged         = get_query_var( 'paged' );

		// Only have sep if there's both prev and next results.
		if ( $paged < 2 || $paged >= $max_num_pages ) {
			$args['sep'] = '';
		}

		if ( $max_num_pages > 1 ) {
			$return  = get_previous_posts_link( $args['prelabel'] );
			$return .= preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&$1', $args['sep'] );
			$return .= get_next_posts_link( $args['nxtlabel'] );
		}
	}
	return $return;

}

常見問題

FAQs
檢視更多 >