Функция the_posts_navigation() - WordPres Коды и Элементы

Содержание

Описание функции
Примеры использования
Отображение навигации между постами
Настройка текста ссылок
Изменение класса элемента навигации
Изменение текста для screen reader
Настройка ARIA-метки
Вопросы и ответы
Как изменить текст ссылки на предыдущие записи?
Как изменить текст ссылки на следующие записи?
Как изменить текст для экранных читалок в навигации?
Как изменить ARIA-метку для навигации?
Как изменить класс для элемента навигации?
Как изменить стиль навигации?
Как скрыть навигацию, если нет следующих или предыдущих записей?
Как изменить порядок ссылок на предыдущие и следующие записи?
Связанные элементы

Описание функции

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

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

the_posts_navigation( array $args = array() )

Функция the_posts_navigation() принимает один необязательный параметр — массив $args, который содержит настройки для отображения навигации. Если параметр не указан, то будут использованы значения по умолчанию.

$args (массив) — Необязательный. См. get_the_posts_navigation() для доступных аргументов. Больше аргументов из get_the_posts_navigation(... $args). По умолчанию: пустой массив.

<?php
$args = array(
    'prev_text'          => '« Предыдущие записи',
    'next_text'          => 'Следующие записи »',
    'screen_reader_text' => 'Навигация по записям',
    'aria_label'         => 'Посты',
    'class'              => 'custom-class'
);
the_posts_navigation( $args );
?>

В приведенном выше примере кода мы создаем массив $args, содержащий все доступные параметры для функции the_posts_navigation(). Затем мы передаем этот массив в функцию, чтобы настроить отображение навигации.

Примеры использования

Отображение навигации между постами


$args = array(
    'prev_text' => 'Previous posts',
    'next_text' => 'Next posts',
);
the_posts_navigation( $args );

В этом примере кода используется функция the_posts_navigation() для отображения навигации между предыдущим и следующим набором постов. В качестве аргумента передается массив $args, в котором можно настроить текст ссылок.

Настройка текста ссылок


$args = array(
    'prev_text' => 'Older posts',
    'next_text' => 'Newer posts',
);
the_posts_navigation( $args );

В данном примере кода используется функция the_posts_navigation() с аргументом $args, в котором заданы пользовательские значения для текста ссылок. В результате, ссылка на предыдущие посты будет отображаться как «Older posts», а ссылка на следующие посты — как «Newer posts».

Изменение класса элемента навигации


$args = array(
    'class' => 'custom-navigation',
);
the_posts_navigation( $args );

В этом примере кода используется функция the_posts_navigation() с аргументом $args, в котором задан пользовательский класс для элемента навигации. В результате, элемент навигации будет иметь класс «custom-navigation».


$args = array(
    'screen_reader_text' => 'Navigation between posts',
);
the_posts_navigation( $args );

В данном примере кода используется функция the_posts_navigation() с аргументом $args, в котором задан пользовательский текст для screen reader. В результате, элемент навигации будет иметь атрибут aria-label со значением «Navigation between posts».

Настройка ARIA-метки


$args = array(
    'aria_label' => 'Custom label',
);
the_posts_navigation( $args );

В этом примере кода используется функция the_posts_navigation() с аргументом $args, в котором задана пользовательская ARIA-метка для элемента навигации. В результате, элемент навигации будет иметь атрибут aria-label со значением «Custom label».

Вопросы и ответы

Как изменить текст ссылки на предыдущие записи?

Для изменения текста ссылки на предыдущие записи используется параметр prev_text. По умолчанию текст ссылки установлен как ‘Older posts’.


$args = array(
    'prev_text' => 'Previous posts'
);
the_posts_navigation($args);

Как изменить текст ссылки на следующие записи?

Для изменения текста ссылки на следующие записи используется параметр next_text. По умолчанию текст ссылки установлен как ‘Newer posts’.


$args = array(
    'next_text' => 'Next posts'
);
the_posts_navigation($args);

Как изменить текст для экранных читалок в навигации?

Для изменения текста для экранных читалок в навигации используется параметр screen_reader_text. По умолчанию текст установлен как ‘Posts navigation’.


$args = array(
    'screen_reader_text' => 'Navigate through posts'
);
the_posts_navigation($args);

Как изменить ARIA-метку для навигации?

Для изменения ARIA-метки для навигации используется параметр aria_label. По умолчанию метка установлена как ‘Posts’.


$args = array(
    'aria_label' => 'Blog posts'
);
the_posts_navigation($args);

Как изменить класс для элемента навигации?

Для изменения класса элемента навигации в функции the_posts_navigation() можно использовать параметр class. По умолчанию класс равен 'posts-navigation'. Чтобы изменить класс, нужно передать новое значение в виде строки.


$args = array(
    'class' => 'custom-navigation'
);
the_posts_navigation($args);

Как изменить стиль навигации?

Для изменения стиля навигации в функции the_posts_navigation() можно использовать параметры prev_text и next_text. По умолчанию текст для ссылки на предыдущие записи — ‘Older posts’, а для ссылки на следующие записи — ‘Newer posts’. Чтобы изменить текст, нужно передать новое значение в виде строки.


$args = array(
    'prev_text' => 'Previous',
    'next_text' => 'Next'
);
the_posts_navigation($args);

Как скрыть навигацию, если нет следующих или предыдущих записей?

Навигация может быть скрыта, если нет следующих или предыдущих записей. Для этого используется функция get_the_posts_navigation(), которая возвращает HTML-код навигации. Если навигация пустая, то она не будет отображаться.


if (get_the_posts_navigation()) {
    the_posts_navigation();
}

Как изменить порядок ссылок на предыдущие и следующие записи?

По умолчанию ссылка на предыдущие записи отображается перед ссылкой на следующие записи. Чтобы изменить порядок, нужно использовать параметр screen_reader_text и передать новое значение в виде строки.


$args = array(
    'screen_reader_text' => 'Posts navigation'
);
the_posts_navigation($args);

Функция the_posts_navigation() отображает навигацию к предыдущему/следующему набору записей, если это применимо. Она принимает необязательный массив аргументов, в котором можно указать различные параметры для настройки навигации. Параметры включают изменение класса элемента навигации, стиля навигации, скрытие навигации при отсутствии записей и изменение порядка ссылок на предыдущие и следующие записи.

Связанные элементы

Функция get_previous_posts_link(): Возвращает HTML-ссылку на предыдущую страницу постов.
Функция get_next_posts_link(): Возвращает HTML-ссылку на следующую страницу постов.
Функция get_the_posts_pagination(): Возвращает HTML-разметку для пагинации постов.
Функция get_the_posts_navigation(): Возвращает HTML-разметку для навигации постов.
Функция the_post_navigation(): Выводит HTML-разметку для навигации между постами.
Функция the_posts_pagination(): Выводит HTML-разметку для пагинации постов.
Хук previous_posts_link_attributes: Позволяет изменить атрибуты ссылки на предыдущую страницу постов.
Хук next_posts_link_attributes: Позволяет изменить атрибуты ссылки на следующую страницу постов.

the_posts_navigation()