wp_img_tag_add_loading_attr │ filter-hook │ WP 5.5.0

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

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

Usage

add_filter( 'wp_img_tag_add_loading_attr', 'wp_kama_img_tag_add_loading_attr_filter', 10, 3 );

/**
 * Function for `wp_img_tag_add_loading_attr` filter-hook.
 * 
 * @param string|bool $value   The `loading` attribute value. Returning a falsey value will result in the attribute being omitted for the image.
 * @param string      $image   The HTML `img` tag to be filtered.
 * @param string      $context Additional context about how the function was called or where the img tag is.
 *
 * @return string|bool
 */
function wp_kama_img_tag_add_loading_attr_filter( $value, $image, $context ){

	// filter...
	return $value;
}

$value(string|true|false)

The loading attribute value. Returning a falsey value will result in the attribute being omitted for the image.

$image(string)

The HTML img tag to be filtered.

$context(string)

Additional context about how the function was called or where the img tag is.

Changelog

Where the hook is called

$filtered_loading_attr = apply_filters(
	'wp_img_tag_add_loading_attr',
	isset( $optimization_attrs['loading'] ) ? $optimization_attrs['loading'] : false,
	$image,
	$context
);

$value = apply_filters( 'wp_img_tag_add_loading_attr', $value, $image, $context );

Where the hook is used in WordPress