posts_nav_link() - WordPress 函数参考中文文档

返回介绍

posts_nav_link()

发布于 2017-09-11 字数4177 浏览 798 评论 0

posts_nav_link( string $sep = '',  string $prelabel = '',  string $nxtlabel = '' )

Displays the post pages link navigation for previous and next pages.


描述


参数

$sep

(string)
(Optional)
Separator for posts navigation links.

Default value: ”

$prelabel

(string)
(Optional)
Label for previous pages.

Default value: ”

$nxtlabel

(string)
(Optional)
Label for next pages.

Default value: ”


源代码

File: wp-includes/link-template.php

function posts_nav_link( $sep = '', $prelabel = '', $nxtlabel = '' ) {
	$args = array_filter( compact('sep', 'prelabel', 'nxtlabel') );
	echo get_posts_nav_link($args);
}

更新日志

Version 描述
0.71 Introduced.

相关函数

Uses

  • wp-includes/link-template.php:
    get_posts_nav_link()

User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Using Images

    
    <?php posts_nav_link( ' ', '<img src="' . esc_attr( get_bloginfo( 'stylesheet_directory' ) . '/images/prev.jpg . ')'" />', '<img src="' . esc_attr( get_bloginfo( 'stylesheet_directory' ) . '/images/next.jpg . ')'" />' ); ?>
    
  2. Default Usage

    By default, the posts_nav_link() look like this:

    « Previous Page — Next Page »

    
    <?php posts_nav_link(); ?>
    

    In Centered DIV

    Displays previous and next page links (“previous page · next page”) centered on the page.

    
    <div style="text-align:center;">
    	<?php posts_nav_link( ' · ', 'previous page', 'next page' ); ?>
    </div>
    

    Kubrick Theme Format

    The Kubrick theme format for posts navigation, could be formatted this way. However, using posts_nav_link() in this way will result in unintended behavior, such as double stacked next and previous links that link to the incorrect sections.

    The Kubrick Theme actually uses next_posts_link() and previous_posts_link().

    This is poor code and should not be used:

    
    <div class="navigation">
    <div class="alignleft"><?php posts_nav_link( '', '', '&laquo; Previous Entries' ); ?></div>
    <div class="alignright"><?php posts_nav_link( '', 'Next Entries &raquo;', '' ); ?></div>
    </div>
    

    This is better code:

    
    <div class="navigation">
    <div class="alignleft"><?php previous_posts_link( '&laquo; Previous Entries' ); ?></div>
    <div class="alignright"><?php next_posts_link( 'Next Entries &raquo;', '' ); ?></div>
    </div>
    

    You can change the text in each of the links and in the text in between the links.

    You can go back to the previous page or you can go forward to the next page.

    
    <p><?php posts_nav_link( ' or ', 'You can go back to the previous page', 'you can go forward to the next page' ); ?>.</p>
    

上一篇:postbox_classes()

下一篇:post_author_meta_box()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!