get_posts_nav_link()
最后更新于:2021-11-26 22:27:02
get_posts_nav_link( string|array$args=array())Retrieves the post pages link navigation for previous and next pages.
参数
- $args
-
(string|array) (Optional) Arguments to build the post pages link navigation.
-
‘sep’
(string) Separator character. Default ‘—’. -
‘prelabel’
(string) Link text to display for the previous page link. Default ‘« Previous Page’. -
‘nxtlabel’
(string) Link text to display for the next page link. Default ‘Next Page »’.
Default value: array()
-
‘sep’
响应
(string) The posts link navigation.
源文件
文件: gc-includes/link-template.php
function get_posts_nav_link( $args = array() ) {
global $gc_query;
$return = '';
if ( ! is_singular() ) {
$defaults = array(
'sep' => ' — ',
'prelabel' => __( '« Previous Page' ),
'nxtlabel' => __( 'Next Page »' ),
);
$args = gc_parse_args( $args, $defaults );
$max_num_pages = $gc_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;
}