Changeset 62656 for trunk/src/wp-includes/block-supports/custom-css.php

Timestamp:

07/07/2026 12:49:04 PM (2 months ago)

Author:

wildworks

Message:

Block Supports: Fix duplicate custom CSS for identical attributes.

wp_render_custom_css_support_styles() runs on every block render, and wp_unique_id_from_values() derives the class name from the block's attributes. Blocks with identical attributes therefore share the same processed CSS, which wp_add_inline_style() re-enqueued on each render, emitting the same rule once per occurrence.

Before enqueuing, skip the CSS if it is already present in the wp-block-custom-css handle's after inline styles`.

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

Props masteradhoc, mukesh27, mustafabharmal, westonruter, wildworks.
Fixes #65268.

File:

• trunk/src/wp-includes/block-supports/custom-css.php (modified) (3 diffs)

trunk/src/wp-includes/block-supports/custom-css.php

@@ -26 +26 @@
  *     ...
  * } $parsed_block
+ * @phpstan-return array{
+ *     blockName: string|null,
+ *     attrs: array{
+ *         className?: string,
+ *         style?: array{
+ *             css?: string,
+ *             ...
+ *         },
+ *         ...
+ *     },
+ *     ...
+ * }
  */
 function wp_render_custom_css_support_styles( $parsed_block ) {
@@ -50 +62 @@
                 : $class_name;
 
-        _wp_array_set( $parsed_block, array( 'attrs', 'className' ), $updated_class_name );
+        $parsed_block['attrs']['className'] = $updated_class_name;
 
         // Process the custom CSS using the same method as global styles.
@@ -57 +69 @@
 
         if ( ! empty( $processed_css ) ) {
-                /*
-                 * Register and add inline style for block custom CSS.
-                 * The style depends on global-styles to ensure custom CSS loads after
-                 * and can override global styles.
+                /**
+                 * Skip CSS that has already been added. Blocks with identical attributes
+                 * share the same class name and processed CSS via {@see wp_unique_id_from_values()},
+                 * so the same style would otherwise be enqueued more than once (e.g. inside
+                 * a Query Loop or when blocks share identical custom CSS).
                  */
-                wp_register_style( 'wp-block-custom-css', false, array( 'global-styles' ) );
-                wp_add_inline_style( 'wp-block-custom-css', $processed_css );
+                $handle = 'wp-block-custom-css';
+                if ( ! wp_style_is( $handle, 'registered' ) ) {
+                        wp_register_style( $handle, false, array( 'global-styles' ) );
+                }
+                $after_styles = wp_styles()->get_data( $handle, 'after' );
+                if ( ! is_array( $after_styles ) ) {
+                        $after_styles = array();
+                }
+                if ( ! in_array( $processed_css, $after_styles, true ) ) {
+                        wp_add_inline_style( $handle, $processed_css );
+                }
         }