wp_get_loading_optimization_attributes( string $tag_name, array $attr, string $context ): array

Description

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Parameters

$tag_namestring

The tag name.

$attrarray

Array of the attributes for the tag.

$contextstring

Context for the element for which the loading optimization attribute is requested.

Return value

array

Loading optimization attributes.

Performance profile

How much work a call to wp_get_loading_optimization_attributes() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Trivial

Touches nothing outside its own arguments.

Scaling

Constant

No loop in the body: the same number of instructions runs whatever you pass in.

Instructions

37–127

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 222.

Plugin surface

4 hooks

Third-party callbacks on 'pre_wp_get_loading_optimization_attributes', 'wp_get_loading_optimization_attributes', 'wp_loading_optimization_force_header_contexts' run inside this call, and their cost is not bounded by anything here.

Called by

6

6 places in core call this, so the cost is paid more often than your own code shows.

What it touches

• hookthird-party callbacksapply_filters()called directly

Further down the call graph this can also reach query, option, cache, serialize and transient. Those are the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 356 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost wp_get_loading_optimization_attributes() can have, taken from its control-flow graph on PHP 8.5.

This body has more branch combinations than are worth enumerating, so the table covers the outcomes found first rather than every one that exists.

Hooks and filters fired · 8

8 hooks fire while wp_get_loading_optimization_attributes() runs, in this order:

1. 1
   apply_filters( pre_wp_get_loading_optimization_attributes )filterline 6166 (+16 into the body)

   Filters whether to short-circuit loading optimization attributes.

2. 2
   apply_filters( wp_get_loading_optimization_attributes )filterline 6180 (+30 into the body)

   Filters the loading optimization attributes.

3. 3
   apply_filters( wp_get_loading_optimization_attributes )filterline 6186 (+36 into the body)

   Filters the loading optimization attributes.

4. 4
   apply_filters( wp_get_loading_optimization_attributes )filterline 6202 (+52 into the body)

   Filters the loading optimization attributes.

5. 5
   apply_filters( wp_get_loading_optimization_attributes )filterline 6217 (+67 into the body)

   Filters the loading optimization attributes.

6. 6
   apply_filters( wp_loading_optimization_force_header_contexts )filterline 6309 (+159 into the body)

   Filters the header-specific contexts.

7. 7
   apply_filters( wp_min_priority_img_pixels )filterline 6377 (+227 into the body)

   Filters the minimum square-pixels threshold for an image to be eligible as the high-priority image.

8. 8
   apply_filters( wp_get_loading_optimization_attributes )filterline 6395 (+245 into the body)

   Filters the loading optimization attributes.

Uses · 12

• apply_filters()Calls the callback functions that have been added to a filter hook.
• doing_filter()Returns whether or not a filter hook is currently being processed.
• _doing_it_wrong()Marks something as being incorrectly called.
• __()Retrieves the translation of $text.
• is_admin()Determines whether the current request is for an administrative interface page.
• in_the_loop()Determines whether the caller is in the Loop.
• is_main_query()Determines whether the query is the main query.
• wp_increase_content_media_count()Increases an internal content media count variable.
• wp_omit_loading_attr_threshold()Gets the threshold for how many of the first content media elements to not lazy-load.
• did_action()Retrieves the number of times an action has been fired during the current request.
• wp_maybe_add_fetchpriority_high_attr()Determines whether to add `fetchpriority='high'` to loading attributes.
• wp_lazy_loading_enabled()Determines whether to add the `loading` attribute to the specified tag in the specified context.

Used by · 6

• WP_Widget_Media_Image::render_media()Render the media on the frontend.
• get_avatar()Retrieves the avatar `` tag for a user, email address, MD5 hash, comment, or post.
• get_header_image_tag()Creates image tag markup for a custom header image.
• wp_get_attachment_image()Gets an HTML img element representing an image attachment.
• wp_iframe_tag_add_loading_attr()Adds `loading` attribute to an `iframe` HTML tag.
• wp_img_tag_add_loading_optimization_attrs()Adds optimization attributes to an `img` HTML tag.

Source code

View on Trac ↗View on GitHub ↗

6150function wp_get_loading_optimization_attributes( $tag_name, $attr, $context ) {6151	global $wp_query;6152 6153	/**6154	 * Filters whether to short-circuit loading optimization attributes.6155	 *6156	 * Returning an array from the filter will effectively short-circuit the loading of optimization attributes,6157	 * returning that value instead.6158	 *6159	 * @since 6.4.06160	 *6161	 * @param array|false $loading_attrs False by default, or array of loading optimization attributes to short-circuit.6162	 * @param string      $tag_name      The tag name.6163	 * @param array       $attr          Array of the attributes for the tag.6164	 * @param string      $context       Context for the element for which the loading optimization attribute is requested.6165	 */6166	$loading_attrs = apply_filters( 'pre_wp_get_loading_optimization_attributes', false, $tag_name, $attr, $context );6167 6168	if ( is_array( $loading_attrs ) ) {6169		return $loading_attrs;6170	}6171 6172	$loading_attrs = array();6173 6174	/*6175	 * Skip lazy-loading for the overall block template, as it is handled more granularly.6176	 * The skip is also applicable for `fetchpriority`.6177	 */6178	if ( 'template' === $context ) {6179		/** This filter is documented in wp-includes/media.php */6180		return apply_filters( 'wp_get_loading_optimization_attributes', $loading_attrs, $tag_name, $attr, $context );6181	}6182 6183	// For now this function only supports images and iframes.6184	if ( 'img' !== $tag_name && 'iframe' !== $tag_name ) {6185		/** This filter is documented in wp-includes/media.php */6186		return apply_filters( 'wp_get_loading_optimization_attributes', $loading_attrs, $tag_name, $attr, $context );6187	}6188 6189	/*6190	 * Skip programmatically created images within content blobs as they need to be handled together with the other6191	 * images within the post content or widget content.6192	 * Without this clause, they would already be considered within their own context which skews the image count and6193	 * can result in the first post content image being lazy-loaded or an image further down the page being marked as a6194	 * high priority.6195	 */6196	if (6197		'the_content' !== $context && doing_filter( 'the_content' ) ||6198		'widget_text_content' !== $context && doing_filter( 'widget_text_content' ) ||6199		'widget_block_content' !== $context && doing_filter( 'widget_block_content' )6200	) {6201		/** This filter is documented in wp-includes/media.php */6202		return apply_filters( 'wp_get_loading_optimization_attributes', $loading_attrs, $tag_name, $attr, $context );6203 6204	}6205 6206	/*6207	 * Add `decoding` with a value of "async" for every image unless it has a6208	 * conflicting `decoding` attribute already present.6209	 */6210	if ( 'img' === $tag_name ) {6211		$loading_attrs['decoding'] = $attr['decoding'] ?? 'async';6212	}6213 6214	// For any resources, width and height must be provided, to avoid layout shifts.6215	if ( ! isset( $attr['width'], $attr['height'] ) ) {6216		/** This filter is documented in wp-includes/media.php */6217		return apply_filters( 'wp_get_loading_optimization_attributes', $loading_attrs, $tag_name, $attr, $context );6218	}6219 6220	/*6221	 * The key function logic starts here.6222	 */6223	$maybe_in_viewport    = null;6224	$increase_count       = false;6225	$maybe_increase_count = false;6226 6227	// Logic to handle a `loading` attribute that is already provided.6228	if ( isset( $attr['loading'] ) ) {6229		/*

Changelog

Introduced in 6.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/media.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.