wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_maybe_add_fetchpriority_high_attr › WordPress Function

Since6.3.0
Deprecatedn/a
wp_maybe_add_fetchpriority_high_attr ( $loading_attrs, $tag_name, $attr )
Access:
  • private
Parameters: (3)
  • (array) $loading_attrs Array of the loading optimization attributes for the element.
    Required: Yes
  • (string) $tag_name The tag name.
    Required: Yes
  • (array) $attr Array of the attributes for the element.
    Required: Yes
Returns:
  • (array) Updated loading optimization attributes for the element.
Defined at:
Codex:

Determines whether to add `fetchpriority='high'` to loading attributes.



Source

function wp_maybe_add_fetchpriority_high_attr( $loading_attrs, $tag_name, $attr ) {
	// For now, adding `fetchpriority="high"` is only supported for images.
	if ( 'img' !== $tag_name ) {
		return $loading_attrs;
	}

	if ( isset( $attr['fetchpriority'] ) ) {
		/*
		 * While any `fetchpriority` value could be set in `$loading_attrs`,
		 * for consistency we only do it for `fetchpriority="high"` since that
		 * is the only possible value that WordPress core would apply on its
		 * own.
		 */
		if ( 'high' === $attr['fetchpriority'] ) {
			$loading_attrs['fetchpriority'] = 'high';
			wp_high_priority_element_flag( false );
		}

		return $loading_attrs;
	}

	// Lazy-loading and `fetchpriority="high"` are mutually exclusive.
	if ( isset( $loading_attrs['loading'] ) && 'lazy' === $loading_attrs['loading'] ) {
		return $loading_attrs;
	}

	if ( ! wp_high_priority_element_flag() ) {
		return $loading_attrs;
	}

	/**
	 * Filters the minimum square-pixels threshold for an image to be eligible as the high-priority image.
	 *
	 * @since 6.3.0
	 *
	 * @param int $threshold Minimum square-pixels threshold. Default 50000.
	 */
	$wp_min_priority_img_pixels = apply_filters( 'wp_min_priority_img_pixels', 50000 );

	if ( $wp_min_priority_img_pixels <= $attr['width'] * $attr['height'] ) {
		$loading_attrs['fetchpriority'] = 'high';
		wp_high_priority_element_flag( false );
	}

	return $loading_attrs;
}