说明
该标签为分页文章(如文章中包含一个或一个以上<!–nextpage–> 快速标签)显示分页链接。与link_pages()运行方式几乎一致,区别在于,该标签的参数以查询字符串形式传递。该标签必须在WordPress主循环(loop)。
用法
<?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' => '%',
'more_file' => ,
'echo' => 1 ); ?>
参数
before
(字符串)显示在所有链接前的文本。默认值为<p>Pages:。
after
(字符串)显示在所有链接后的文本。默认值为</p>。.
link_before
(字符串)链接文本前的文字。默认值为(blank)(空)。在WP 2.7以及更高版本中,该参数为必要参数。
link_after
(字符串)链接文本后的文字。默认值为(blank)(空)。在WP 2.7以及更高版本中,该参数为必要参数。
next_or_number
(字符串)是否使用页数。有效值包括:
- number(默认)
- next(WP 1.5及之后版本中有效)
nextpagelink
(字符串)下一页链接的链接文本。默认值为Next page(下一页)。(WP 1.5及之后版本中有效)
previoustpagelink
(字符串)上一页链接的链接文本。默认值为Previous page(上一页)。(WP 1.5及之后版本中有效)
pagelink
(字符串)页数的格式化字符串。字符串中的%会被替换为数字,因此Page % 会转换成"Page 1"、"Page 2"等。默认为%。
more_file
(字符串)链接所指向的网页。默认为当前页面。
echo
(布尔型)响应或返回结果。默认值为true。有效值包括:
- 1 (True)—— 默认值
- 0(False)
示例
默认用法
默认显示分页链接,链接前后有段落标签,分页链接文本为Next page 与Previous page,所有页面按1、2、3这样的编号顺序显示。
<?php wp_link_pages(); ?>
段落标签中的分页链接
显示由段落标签包裹着的分页链接。
<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>
DIV中的分页链接
在CSS引用的DIV中显示分页链接(div id="page-links")。
<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>
历史记录
- 始见于WordPress 0.71版本
源文件
wp_link_pages()位于wp-includes/post-template.php
分类:中文手册