W3cubDocs

/WordPress

posts_nav_link( string $sep = , string $prelabel = , string $nxtlabel = )

Displays the post pages link navigation for previous and next pages.

Parameters

$sepstringoptional
Separator for posts navigation links.

Default:''

$prelabelstringoptional
Label for previous pages.

Default:''

$nxtlabelstringoptional
Optional Label for next pages.

Default:''

More Information

For displaying next and previous pages of posts see next_posts_link() and previous_posts_link().

For displaying next and previous post navigation on individual posts, see next_post_link() and previous_post_link().

Note: since weblog posts are traditionally listed in reverse chronological order (with most recent posts at the top), there is some ambiguity in the definition of “next page”. WordPress defines “next page” as the “next page toward the past“.

Source

function posts_nav_link( $sep = '', $prelabel = '', $nxtlabel = '' ) {
	$args = array_filter( compact( 'sep', 'prelabel', 'nxtlabel' ) );
	echo get_posts_nav_link( $args );
}

Changelog

Version Description
0.71 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/posts_nav_link