get_posts_nav_link() - WordPress 函数参考中文文档

返回介绍

get_posts_nav_link()

发布于 2017-09-10 字数2570 浏览 757 评论 0

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


返回值

(string) The posts link navigation.


源代码

File: wp-includes/link-template.php

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;

}

更新日志

Version 描述
2.8.0 Introduced.

相关函数

Uses

  • wp-includes/l10n.php:
    __()
  • wp-includes/query.php:
    is_singular()
  • wp-includes/query.php:
    get_query_var()
  • wp-includes/functions.php:
    wp_parse_args()
  • wp-includes/link-template.php:
    get_previous_posts_link()
  • wp-includes/link-template.php:
    get_next_posts_link()
  • Show 1 more use
    Hide more uses


Used By

  • wp-includes/link-template.php:
    posts_nav_link()

User Contributed Notes

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!