get_the_posts_navigation()

Возвращает навигацию к следующему/предыдущему набору записей, если применимо
Функция WordPress
INT 4.1.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Генерация навигации постов с использованием стандартных настроек
  4. Настройка текста ссылок в навигации постов
  5. Изменение текста для чтения скринридерами в навигации постов
  6. Изменение класса элемента навигации постов
  7. Изменение текста ссылок и класса элемента навигации постов
  8. Изменение ARIA-метки для элемента навигации постов
  9. Вопросы и ответы
  10. Как изменить текст ссылки на предыдущие посты?
  11. Как изменить текст ссылки на следующие посты?
  12. Как изменить текст для screen reader в навигации постов?
  13. Как изменить ARIA label для навигации постов?
  14. Как изменить класс для элемента навигации постов?
  15. Как изменить разметку ссылок в навигации постов?
  16. Функция get_the_posts_navigation()
  17. Как изменить порядок ссылок в навигации постов?
  18. Как добавить дополнительные атрибуты к ссылкам в навигации постов?
  19. Как стилизовать навигацию постов с помощью CSS?
  20. Связанные элементы

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

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

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

get_the_posts_navigation( array $args = array() ): string

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

  • $args (массив) — Необязательный. Аргументы для навигации по записям.
    • prev_text (строка) — Текст ссылки на предыдущие записи. По умолчанию: ‘Старые записи’.
    • next_text (строка) — Текст ссылки на следующие записи. По умолчанию: ‘Новые записи’.
    • screen_reader_text (строка) — Текст для считывающих устройств для элемента навигации. По умолчанию: ‘Навигация по записям’.
    • aria_label (строка) — Текст метки ARIA для элемента навигации. По умолчанию: ‘Записи’.
    • class (строка) — Пользовательский класс для элемента навигации. По умолчанию: ‘posts-navigation’.

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

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

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

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

Генерация навигации постов с использованием стандартных настроек


// Генерация навигации постов с использованием стандартных настроек
echo get_the_posts_navigation();

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

Настройка текста ссылок в навигации постов


// Настройка текста ссылок в навигации постов
$args = array(
    'prev_text' => 'Previous posts',
    'next_text' => 'Next posts'
);
echo get_the_posts_navigation($args);

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

Изменение текста для чтения скринридерами в навигации постов


// Изменение текста для чтения скринридерами в навигации постов
$args = array(
    'screen_reader_text' => 'Navigation through posts'
);
echo get_the_posts_navigation($args);

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

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


// Изменение класса элемента навигации постов
$args = array(
    'class' => 'custom-posts-navigation'
);
echo get_the_posts_navigation($args);

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

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


// Изменение текста ссылок и класса элемента навигации постов
$args = array(
    'prev_text' => 'Older entries',
    'next_text' => 'Newer entries',
    'class' => 'custom-posts-navigation'
);
echo get_the_posts_navigation($args);

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

Изменение ARIA-метки для элемента навигации постов


// Изменение ARIA-метки для элемента навигации постов
$args = array(
    'aria_label' => 'Navigation'
);
echo get_the_posts_navigation($args);

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

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

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

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


$args = array(
    'prev_text' => 'Previous posts',
);
echo get_the_posts_navigation($args);

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

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


$args = array(
    'next_text' => 'Next posts',
);
echo get_the_posts_navigation($args);

Как изменить текст для screen reader в навигации постов?

Для изменения текста, который будет использоваться screen reader’ом при навигации постов, необходимо использовать параметр screen_reader_text при вызове функции get_the_posts_navigation(). По умолчанию текст установлен как ‘Posts navigation’.


$args = array(
    'screen_reader_text' => 'Navigation',
);
echo get_the_posts_navigation($args);

Как изменить ARIA label для навигации постов?

Для изменения ARIA label для навигации постов можно использовать параметр aria_label при вызове функции get_the_posts_navigation(). По умолчанию, ARIA label установлен как ‘Posts’.


$args = array(
    'aria_label' => 'Custom ARIA label'
);
echo get_the_posts_navigation($args);

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

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


$args = array(
    'class' => 'custom-class'
);
echo get_the_posts_navigation($args);

Как изменить разметку ссылок в навигации постов?

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


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

Функция get_the_posts_navigation()

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

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

Порядок ссылок в навигации постов можно изменить с помощью параметров функции get_the_posts_navigation().


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

Как добавить дополнительные атрибуты к ссылкам в навигации постов?

Дополнительные атрибуты к ссылкам в навигации постов можно добавить с помощью параметров функции get_the_posts_navigation().


$args = array(
    'prev_text' => 'Newer posts',
    'next_text' => 'Older posts',
    'screen_reader_text' => 'Custom screen reader text',
    'aria_label' => 'Custom ARIA label',
    'class' => 'custom-class',
);
get_the_posts_navigation($args);

Как стилизовать навигацию постов с помощью CSS?

Навигацию постов можно стилизовать с помощью CSS, добавив класс к навигационному элементу.


.posts-navigation {
    /* CSS стили для навигации постов */
}

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

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

  • Хук pre_get_posts: позволяет изменить параметры запроса перед выполнением запроса к базе данных.
  • Класс WP_Query: используется для выполнения запросов к базе данных WordPress и получения постов.
  • Класс WP_Post: представляет отдельный пост в WordPress.
Обсуждение