Changeset 47554 for trunk/src/wp-includes/pluggable.php

Timestamp:

04/08/2020 12:53:18 AM (5 years ago)

Author:

azaozz

Message:

Media: Enable lazy-loading of images by automatically adding the new loading="lazy" attribute to image tags on the front-end.

• Introduces wp_lazy_loading_enabled(), wp_filter_content_tags(), wp_img_tag_add_loading_attr(), and wp_img_tag_add_srcset_and_sizes_attr() functions.
• Introduces wp_lazy_loading_enabled, wp_img_tag_add_loading_attr, and wp_img_tag_add_srcset_and_sizes_attr filters.

Props flixos90, addyosmani, mor10, swissspidy, pierlo, westonruter, spacedmonkey, mikeschroder, jonoaldersonwp, peterwilsoncc, narwen, jeffpaul, OptimizingMatters, futtta, mukeshpanchal27, azaozz.

Fixes #44427.

File:

• trunk/src/wp-includes/pluggable.php (modified) (4 diffs)

trunk/src/wp-includes/pluggable.php

@@ -2607 +2607 @@
      *     @type bool         $force_display Whether to always show the avatar - ignores the show_avatars option.
      *                                       Default false.
+     *     @type string       $loading       Value for the `loading` attribute.
+     *                                       Default null.
      *     @type string       $extra_attr    HTML attributes to insert in the IMG element. Is not sanitized. Default empty.
      * }
@@ -2624 +2626 @@
             'class'         => null,
             'force_display' => false,
+            'loading'       => null,
             'extra_attr'    => '',
         );
+
+        if ( wp_lazy_loading_enabled( 'img', 'get_avatar' ) ) {
+            $defaults['loading'] = 'lazy';
+        }
 
         if ( empty( $args ) ) {
@@ -2694 +2701 @@
                 $class[] = $args['class'];
             }
+        }
+
+        // Add `loading` attribute.
+        $extra_attr = $args['extra_attr'];
+        $loading    = $args['loading'];
+
+        if ( in_array( $loading, array( 'lazy', 'eager' ), true ) && ! preg_match( '/\bloading\s*=/', $extra_attr ) ) {
+            if ( ! empty( $extra_attr ) ) {
+                $extra_attr .= ' ';
+            }
+
+            $extra_attr .= "loading='{$loading}'";
         }
 
@@ -2704 +2723 @@
             (int) $args['height'],
             (int) $args['width'],
-            $args['extra_attr']
+            $extra_attr
         );