正文 评论

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

相关函数:

  • 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()

回复

暂无评论