posts_nav_link()
Выводит ссылки на предыдущую и следующую страницы (посты/категории). Может пригодится для того, чтобы снабдить архивы ссылками навигации.
Чтобы получить ссылки на предыдущий/следующий посты в отдельности используйте функции: next_post_link() и previous_post_link().
Работает на основе: get_posts_nav_link()
Хуков нет.
Возвращает
null.
Использование
<?php posts_nav_link( $sep, $prelabel, $nextlabel ); ?>
- $sep(строка)
- Текст отображаемый между ссылок.
По умолчанию: ' — ' - $prelabel(строка)
- Текст (анкор) ссылки для предыдущего поста.
По умолчанию: __('« Previous Page') - $nxtlabel(строка)
- Текст (анкор) ссылки для следующего поста.
По умолчанию: __('Next Page »')
Примеры
#1 В качестве анкоров ссылок можно использовать картинки, например так:
<?php posts_nav_link( ' ', '<img src="' . get_stylesheet_directory_uri() . '/images/prev.jpg" />', '<img src="' . get_stylesheet_directory_uri() . '/images/next.jpg" />' ); ?>
#2 Чтобы отцентрировать (показать по середине страницы) используйте такой код:
<div style="text-align:center;">
<?php posts_nav_link(' · ', 'Предыдущая страница', 'Следующая страница'); ?>
</div> #3 HTML который выводит функция
<?php posts_nav_link( $sep, $prelabel, $nextlabel ); ?>
Выведет:
<a href="ссылка">« Предыдущая страница</a> — <a href="ссылка">Следующая страница »</a>
Список изменений
| С версии 0.71 | Введена. |
Код posts_nav_link() posts nav link WP 6.7.1
function posts_nav_link( $sep = '', $prelabel = '', $nxtlabel = '' ) {
$args = array_filter( compact( 'sep', 'prelabel', 'nxtlabel' ) );
echo get_posts_nav_link( $args );
}