# _navigation_markup()

URL: https://chugunov.pro/api-wordpress/functions/_navigation_markup/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.1.0.

## Сигнатура

```php
_navigation_markup( string $links, string $css_class = 'posts-navigation', string $screen_reader_text = '', string $aria_label = '' ): string
```

## Описание

Оборачивает переданные ссылки в навигационную разметку.

## Параметры

- `$links` `string` — обязательный. Навигационные ссылки.
- `$css_class` `string` — необязательный, по умолчанию `'posts-navigation'`. Произвольный класс для элемента nav.
  
  Значение по умолчанию 'posts-navigation'.
- `$screen_reader_text` `string` — необязательный, по умолчанию `''`. Текст для программ чтения с экрана для элемента nav.
  
  Значение по умолчанию ‘Posts navigation’.
- `$aria_label` `string` — необязательный, по умолчанию `''`. ARIA-метка для элемента nav.
  
  По умолчанию принимает значение $screen_reader_text.

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

`string`

## Исходный код

Файл: `wp-includes/link-template.php:3033`

```php
function _navigation_markup( $links, $css_class = 'posts-navigation', $screen_reader_text = '', $aria_label = '' ) {
	if ( empty( $screen_reader_text ) ) {
		$screen_reader_text = /* translators: Hidden accessibility 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 the navigation markup template.
	 *
	 * Note: The filtered template HTML must contain specifiers for the navigation
	 * class (%1$s), the screen-reader-text value (%2$s), placement of the navigation
	 * links (%3$s), and ARIA label text if screen-reader-text does not 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 $css_class The class passed by the calling function.
	 */
	$template = apply_filters( 'navigation_markup_template', $template, $css_class );

	return sprintf( $template, sanitize_html_class( $css_class ), esc_html( $screen_reader_text ), $links, esc_attr( $aria_label ) );
}
```

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

- 5.3.0 — Added the aria_label parameter.
- 4.1.0 — Introduced.

## Связанные

Использует: [`sanitize_html_class`](https://chugunov.pro/api-wordpress/functions/sanitize_html_class/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`esc_html`](https://chugunov.pro/api-wordpress/functions/esc_html/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`get_the_comments_navigation`](https://chugunov.pro/api-wordpress/functions/get_the_comments_navigation/), [`get_the_comments_pagination`](https://chugunov.pro/api-wordpress/functions/get_the_comments_pagination/), [`get_the_post_navigation`](https://chugunov.pro/api-wordpress/functions/get_the_post_navigation/), [`get_the_posts_navigation`](https://chugunov.pro/api-wordpress/functions/get_the_posts_navigation/), [`get_the_posts_pagination`](https://chugunov.pro/api-wordpress/functions/get_the_posts_pagination/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_navigation_markup/