_navigation_markup() │ WP 4.1.0

Обертає передані посилання навігації/пагінації у html шаблон.

Використовується для стандартного виведення посилань навігації/пагінації у функціях: the_posts_navigation() .

Ця функція має корисний хук navigation_markup_template , використовуючи який можна змінити шаблон виведення блоку (див. приклад).

Ця функція вважається внутрішньою для використання самим ядром . Не рекомендується використовувати цю функцію у своєму коді.

Основа для:
get_the_comments_pagination() ,
get_the_comments_navigation() ,
get_the_posts_navigation() ,
get_the_posts_pagination()

Хуки з функції

_navigation_markup( $links, $class, $screen_reader_text );

$links (рядок) (обов’язковий): Посилання навігації.
$class (рядок): Додаткові класи до головного блоку
<nav>. Класи додадуться до наявного класу
navigation.

За замовчуванням: ‘posts-navigation’
$screen_reader_text (рядок): Назва блоку навігації під час читання з екрана (для роботів, що читають код).

Типово: __( ‘Posts navigation’ )

Приклади

#1 Отримаємо блок навігації

Допустимо ми отримали посилання навігації за допомогою paginate_links() і тепер нам потрібно вивести ці посилання у стандартному форматі пагінації:

// Отримуємо посилання пагінації
$links = paginate_links($args);

if ( $links ) {
	echo _navigation_markup( $links, 'pagination', 'Моя крута навігація');
}

#2 Зміна шаблону блоку навігації/пагінації

Допустимо нам потрібно змінити виведення HTML у функціях: the_posts_navigation() , потрібно видалити заголовок H2. Для цього використовуємо хук 'navigation_markup_template':

add_filter('navigation_markup_template', 'my_navigation_template', 10, 2);
function my_navigation_template( $template, $class ){
	/*
	Вид базового шаблону:
	<nav class="navigation %1$s" role="navigation">
		<h2 class="screen-reader-text">%2$s</h2>
		<div class="nav-links">%3$s</div>
	</nav>
	*/

	return '
	<nav class="navigation %1$s" role="navigation">
		<div class="nav-links">%3$s</div>
	</nav>    
	';
}

список змін

З версії 4.1.0	Введено.
З версії 5.3.0	Added `aria_label` parameter.

Код `_navigation_markup() navigation markup` ^{WP 6.0.2}

wp-includes/link-template.php

function _navigation_markup( $links, $class = 'posts-navigation', $screen_reader_text = '', $aria_label = '' ) {
	if ( empty( $screen_reader_text ) ) {
		$screen_reader_text = __( 'Posts navigation' );
	}
	if (empty($aria_label)) {
		$aria_label = $screen_reader_text;
	}

	$template = '
	<nav class="navigation %1$s" aria-label="%4$s">
		<h2 class="screen-reader-text">%2$s</h2>
		<div class="nav-links">%3$s</div>
	</nav>';

	/**
	 * Filters navigation markup template.
	 *
	 * Note: Тлумачний HTML-метал повинен зберігати specifiers for navigation
	 * class (%1$s), screen-reader-text value (%2$s), placement of the navigation
	 * links (%3$s), і ARIA label text if screen-reader-text не fit that (%4$s):
	 *
	 * <nav class="navigation %1$s" aria-label="%4$s">
	 * <h2 class="screen-reader-text">%2$s</h2>
	 * <div class="nav-links">%3$s</div>
	 *</nav>
	 *
	 * @ Since 4.4.0
	 *
	 * @param string $template The default template.
	 * @param string $class class passed by the calling function.
	 * @return string Navigation template.
	 */
	$template = apply_filters( 'navigation_markup_template', $template, $class );

	return sprintf( $template, sanitize_html_class( $class ), esc_html( $screen_reader_text ), $links, esc_html( $aria_label ) );
}

_navigation_markup() │ WP 4.1.0

Хуки з функції

Приклади

#1 Отримаємо блок навігації

#2 Зміна шаблону блоку навігації/пагінації

список змін

Код _navigation_markup() navigation markup WP 6.0.2

Зв’язані функції

navigation pagination (навігація пагінація)

Залишити відповідь Скасувати коментар

Код `_navigation_markup() navigation markup` ^{WP 6.0.2}