Changeset 60920 for trunk/src/wp-includes/class-wp-styles.php

Timestamp:

10/10/2025 04:17:22 AM (2 months ago)

Author:

westonruter

Message:

Script Loader: Use original stylesheet URL for sourceURL when inlined.

For inline styles which had been inlined from registered external stylesheets via wp_maybe_inline_styles(), this defers to using the original stylesheet URL for the sourceURL as opposed to fabricating one from the stylesheet handle. This makes the sourceURL much more useful for debugging, as it indicates where the stylesheet is located. This allows a developer to make a change to the CSS more easily.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10177.

Follow-up to [50836].

Props westonruter, mukesh27, gziolo.
See #50328, #52620.
Fixes #63887.

File:

• trunk/src/wp-includes/class-wp-styles.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-styles.php

@@ -334 +334 @@
         $output = $this->get_data( $handle, 'after' );
 
-        if ( empty( $output ) ) {
+        if ( empty( $output ) || ! is_array( $output ) ) {
             return false;
         }
 
         if ( ! $this->do_concat ) {
+
+            // Obtain the original `src` for a stylesheet possibly inlined by wp_maybe_inline_styles().
+            $inlined_src = $this->get_data( $handle, 'inlined_src' );
+
+            // If there's only one `after` inline style, and that inline style had been inlined, then use the $inlined_src
+            // as the sourceURL. Otherwise, if there is more than one inline `after` style associated with the handle,
+            // then resort to using the handle to construct the sourceURL since there isn't a single source.
+            if ( count( $output ) === 1 && is_string( $inlined_src ) && strlen( $inlined_src ) > 0 ) {
+                $source_url = esc_url_raw( $inlined_src );
+            } else {
+                $source_url = rawurlencode( "{$handle}-inline-css" );
+            }
+
             $output[] = sprintf(
                 '/*# sourceURL=%s */',
-                rawurlencode( "{$handle}-inline-css" )
+                $source_url
             );
         }