Получение навигации постов (GET_THE_POSTS_NAVIGATION) в WordPress

Функция get_the_posts_navigation() помогает создать навигационную панель для перехода к следующему или предыдущему набору постов. Она используется на страницах архивов, таких как категории и метки.

Навигационные ссылки можно получить с помощью функций get_next_posts_link() и get_previous_posts_link().

Если вам нужна навигация для одного поста, используйте функцию the_post_navigation().

Возвращаемое значение

Функция возвращает строку — HTML код для перехода к предыдущему и следующему набору постов.

Использование

Чтобы использовать функцию get_the_posts_navigation(), вызовите её с аргументами:

get_the_posts_navigation( $args );

Аргументы

Аргументы передаются в виде массива. По умолчанию это пустой массив. Вот основные аргументы для настройки навигации:

• prev_text (строка): Текст ссылки для перехода к предыдущим постам. По умолчанию: 'Older posts' (Старые посты).
• next_text (строка): Текст ссылки для перехода к следующим постам. По умолчанию: 'Newer posts' (Новые посты).
• screen_reader_text (строка): Текст для экранных читалок для элемента навигации. По умолчанию: 'Posts navigation' (Навигация по постам).
• aria_label (строка): ARIA метка для элемента навигации. По умолчанию: 'Posts' (Посты).
• class (строка): Пользовательский класс для элемента навигации. По умолчанию: 'posts-navigation'.

Пример

Вот пример использования этой функции:

the_posts_navigation( [
    'prev_text'          => '← Prev',
    'next_text'          => 'Next →',
    'screen_reader_text' => 'Моя навигация',
] );

Результатом будет следующий HTML код:

Примечания

• Глобальная переменная: Внутри функции используется переменная $wp_query, которая является объектом запроса WordPress.

История изменений

• С версии 4.1.0: Функция была добавлена.
• С версии 5.3.0: Добавлен параметр aria_label.
• С версии 5.5.0: Добавлен параметр class.

Связанные функции

1. _navigation_markup(): Обработка разметки навигации для обеспечения доступности.
2. get_next_posts_page_link(): Получение ссылки на следующую страницу постов.
3. get_previous_posts_page_link(): Получение ссылки на предыдущую страницу постов.
4. the_comments_navigation(): Навигация по комментариям.
5. the_post_navigation(): Навигация по одиночному посту.

Эти функции могут помочь вам в более сложных сценариях навигации вашего сайта на WordPress.