_navigation_markup()

Wraps在导航标记中传递了链接。

原型

_navigation_markup( string $links, string $class = 'posts-navigation', string $screen_reader_text = '' )

参数

$links (string) (Required) 导航链接。

$class (string) (Optional)  nav元素的自定义类。默认值：‘posts-navigation’。

$screen_reader_text (string) (Optional)  nav元素的屏幕阅读器文本。默认值：‘帖子导航’。

返回值

(string)  导航模板标记。

源文件

路径：wp-includes/link-template.php

<?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" role="navigation">
		<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 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 );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/_navigation_markup/