_navigation_markup

函数


_navigation_markup ( $links, $class = 'posts-navigation', $screen_reader_text = '', $aria_label = '' )
Access
Private
参数
  • (string)
    $links
    Navigational links.
    Required:
  • (string)
    $class
    Optional. Custom class for the nav element. Default ‘posts-navigation’.
    Required:
    Default: ‘posts-navigation’
  • (string)
    $screen_reader_text
    Optional. Screen reader text for the nav element. Default ‘Posts navigation’.
    Required:
    Default: (empty)
  • (string)
    $aria_label
    Optional. ARIA label for the nav element. Defaults to the value of `$screen_reader_text`.
    Required:
    Default: (empty)
返回值
  • (string) Navigation template tag.
定义位置
  • wp-includes/link-template.php
    , line 2933
引入
4.1.0
弃用

Wraps passed links in navigational markup.

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 = '
	';

	/**
	 * 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):
	 *
	 *     
	 *
	 * @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, esc_html( $aria_label ) );
}