wpseek.com
A WordPress-centric search engine for devs and theme authors
wp_img_tag_add_loading_attr › WordPress Function
Since5.5.0
Deprecatedn/a
› wp_img_tag_add_loading_attr ( $image, $context )
Parameters: (2) |
|
Returns: |
|
Defined at: |
|
Codex: |
Adds `loading` attribute to an `img` HTML tag.
Source
function wp_img_tag_add_loading_attr( $image, $context ) { // 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 ( false === strpos( $image, ' src="' ) || false === strpos( $image, ' width="' ) || false === strpos( $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; }