WordPress模板函数wp_link_pages用于输出文章内容翻页，需要在文章内容中插入<!–nextpage–>函数。

wp_link_pages( array|string $args = '' )

函数参数

$args

数组或字符串值

wp_link_pages()函数$args参数默认的值如下：

$args = array(
	'before'           => '<p>' . __( 'Pages:' ),
	'after'            => '</p>',
	'link_before'      => '',
	'link_after'       => '',
	'next_or_number'   => 'number',
	'separator'        => ' ',
	'nextpagelink'     => __( 'Next page' ),
	'previouspagelink' => __( 'Previous page' ),
	'pagelink'         => '%',
	'echo'             => 1
);

wp_link_pages()函数$args参数可用的值如下：

before

字符串值，默认值：<p>页面：

提供一个字符串在分页导航前输出

after

字符串值，默认值：</p>

提供一个字符串在分页导航后输出，主要用于关闭before里设置的函数。

link_before

字符串值，默认为空

用于在链接锚文本前输出内容。

link_after

字符串值，默认为空

用于在链接锚文本后输出内容。

next_or_number

字符串值，默认值：number

指定分页的显示方式

• number：以数字的方式显示分页导航；
• next：分页导航以“上一页”、“下一页”的方式显示。

separator

字符串值，默认为空格

页码之前输出，默认页码之间用空格分隔。

nextpagelink

字符串值，默认值：下一页

当next_or_number的值为next时，nextpagelink的值指定下一页的文本。

previouspagelink

字符串值，默认值：上一页

当next_or_number的值为next时，previouspagelink的值指定上一页的文本。

pagelink

字符串值，默认值：%

格式化分页链接文本，%表示页码。

echo

布尔值，默认值：true

是否输出结果，为false时只返回结果而不输出。

函数使用示例

用<div>函数包裹分页链接

<?php
	$args = array(
		'before' => '<div id="page-links">分页：',
		'after' => '</div>',
	);
	wp_link_pages( $args );
?>

下面的代码输出一样的结果：

<?php wp_link_pages( 'before=<div id="page-links">分页：&after=</div>' ); ?>

扩展阅读

wp_link_pages()函数位于：wp-includes/post-template.php

相关函数：

• posts_nav_link()
• next_posts_link()
• previous_posts_link()
• get_next_posts_link()
• get_previous_posts_link()
• paginate_links()
• next_post_link()
• previous_post_link()
• the_posts_pagination()
• get_the_posts_pagination()