wp_img_tag_add_loading_attr – Hook | Developer.WordPress.org

Filters the loading attribute value to add to an image. Default lazy.

Description

Returning false or an empty string will not add the attribute.
Returning true will add the default value.

Parameters

$valuestring|bool: The loading attribute value. Returning a falsey value will result in the attribute being omitted for the image.
$imagestring: The HTML img tag to be filtered.
$contextstring: Additional context about how the function was called or where the img tag is.

Source

$fetchpriority_val = preg_match( '/ fetchpriority=["\']([A-Za-z]+)["\']/', $image, $match_fetchpriority ) ? $match_fetchpriority[1] : null;
$decoding_val      = preg_match( '/ decoding=["\']([A-Za-z]+)["\']/', $image, $match_decoding ) ? $match_decoding[1] : null;

/*
 * Get loading optimization attributes to use.
 * This must occur before the conditional check below so that even images

View all references View on Trac View on GitHub

Changelog

Version	Description
5.5.0	Introduced.

User Contributed Notes

Skip to note 2 content

Kresimir Pendic 2 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
tl;dr ⨪ this will fix your LCP in pagespeed report for lazy loaded images above the fold

This filter is very useful for images above the fold that don’t need to be lazy loaded (for example logos, featured images etc) so we can hook this filter to read our images and parse for example some custom class that can set lazy loading attribute ON or OFF per image.

– by setting custom class `skip-lazy` inside admin under `Advanced > Additional Classes` inside image settings:
```
add_filter( 'wp_img_tag_add_loading_attr', function( $value, $image ){
	if ( false !== strpos( $image, 'skip-lazy' ) ){
		return false;
	}
	return true;
}, 10, 2 );
```
disables it
Log in to add feedback

apply_filters( ‘wp_img_tag_add_loading_attr’, string|bool $value, string $image, string $context )

In this article

Description

Parameters

Source

Changelog

User Contributed Notes