This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.
_navigation_markup( string $links, string $css_class = 'posts-navigation', string $screen_reader_text = '', string $aria_label = '' )
Wraps passed links in navigational markup.
Parameters
- $links
-
(Required) Navigational links.
- $css_class
-
(Optional) Custom class for the nav element.<br> Default 'posts-navigation'.
Default value: 'posts-navigation'
- $screen_reader_text
-
(Optional) Screen reader text for the nav element.<br> Default 'Posts navigation'.
Default value: ''
- $aria_label
-
(Optional) ARIA label for the nav element.<br> Defaults to the value of
$screen_reader_text
.Default value: ''
Return
(string) Navigation template tag.
Source
File: wp-includes/link-template.php
function _navigation_markup( $links, $class = 'posts-navigation', $screen_reader_text = '' ) {
if ( empty( $screen_reader_text ) ) {
$screen_reader_text = __( 'Posts navigation' );
}
$template = '
<nav class="navigation %1$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), and placement of the
* navigation links (%3$s):
*
* <nav class="navigation %1$s" role="navigation">
* <h2 class="screen-reader-text">%2$s</h2>
* <div class="nav-links">%3$s</div>
* </nav>
*
* @since WP-4.4.0
*
* @param string $template The default template.
* @param string $class The 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 );
}
Changelog
Version | Description |
---|---|
5.3.0 | Added the aria_label parameter. |
4.1.0 | Introduced. |