WordPress文章内容分页标签:wp_link_pages

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

相关函数:

阿里云