This function has been deprecated. Use wp_img_tag_add_loading_optimization_attrs() instead.
wp_img_tag_add_loading_attr( string $image, string $context )
Adds loading
attribute to an img
HTML tag.
Description
See also
Parameters
- $image
-
(Required) The HTML
img
tag where the attribute should be added. - $context
-
(Required) Additional context to pass to the filters.
Return
(string) Converted img
tag with loading
attribute added.
Source
File: wp-includes/deprecated.php
function wp_img_tag_add_loading_attr( $image, $context ) {
_deprecated_function( __FUNCTION__, '6.3.0', 'wp_img_tag_add_loading_optimization_attrs' );
/*
* Get loading attribute value to use. This must occur before the conditional check below so that even images that
* are ineligible for being lazy-loaded are considered.
*/
$value = wp_get_loading_attr_default( $context );
// Images should have source and dimension attributes for the `loading` attribute to be added.
if ( ! str_contains( $image, ' src="' ) || ! str_contains( $image, ' width="' ) || ! str_contains( $image, ' height="' ) ) {
return $image;
}
/**
* 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.
*
* @since 5.5.0
*
* @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.
*/
$value = apply_filters( 'wp_img_tag_add_loading_attr', $value, $image, $context );
if ( $value ) {
if ( ! in_array( $value, array( 'lazy', 'eager' ), true ) ) {
$value = 'lazy';
}
return str_replace( '<img', '<img loading="' . esc_attr( $value ) . '"', $image );
}
return $image;
}
Changelog
Version | Description |
---|---|
6.3.0 | Use wp_img_tag_add_loading_optimization_attrs() instead. |
5.5.0 | Introduced. This function has been deprecated. Use wp_img_tag_add_loading_optimization_attrs() instead. |