> WordPress中文手册 > wordpress文章分页函数:wp_link_pages()

【函数介绍】

wp_link_pages()是WordPress文章内页分页函数,在文章过长的时候我们通常需要对文章内容进行分页。
实例介绍可查看:wordpress文章太长添加内页分页功能
实例应用可查看:wordpress后台操作详细教程

【函数用法】

<?PHP wp_link_pages( $args ); ?> 

【参数说明】

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

before

(字符串) 显示在分页之前的文本。默认为:

Pages:.

after

(字符串) 显示在分页之后的文本. 默认为:

.

link_before

(字符串) 在每个分页链接之前的文本. 默认为一个空格. 需要wordpress 2.7 +支持

link_after

(字符串)在每个分页后显示的文本.默认为一个空格. 需要wordpress 2.7 +支持

next_or_number

(字符串) 选择使用数字链接还是下一个链接. 可用的链接如下:

数字 (默认)

下一页 (wordpress1.5+支持)

nextpagelink

(字符串) 下一页链接. 默认为: Next page. (需要 wordpress1.5+ 支持)

previouspagelink

(字符串) 上一页链接. 默认为:Previous page. (需要 wordpress1.5+ 支持)

pagelink

(字符串) 格式化链接. “%”在代码中将会被分页数字所替代 , 因此 % 可以显示为 “Page 1″, “Page 2″, 等等.默认为: %.

more_file

(字符串) 链接指向. 默认为当前页

echo

(布尔型) )切换是否呼应或返回结果. 默认值为true. 可用的值为:

1 (True) – 默认

0 (False)

【函数实例】

显示段落标记的默认页面链接之前和之后,使用下一页和前一页 ,列出页码为第1,第2,依此类推。

<?php wp_link_pages(); ?>

段落标记的网页链接

显示包裹在段落标记的页面链接。

<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>

在DIV的网页链接

显示页面的DIV CSS

<div id=”page-links”>

参考链接。

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

【函数源文件】

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