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

Timestamp:

07/13/2026 09:41:34 AM (9 days ago)

Author:

wildworks

Message:

Block Supports: Ensure custom CSS prints after block library styles.

The wp-block-custom-css handle depended only on global-styles, which pulled global-styles forward in the print order, ahead of wp-block-library. Block library default styles then printed last and overrode global styles.

Declare wp-block-library before global-styles in the handle's dependency array so wp-block-library prints first and global-styles keeps winning the cascade.

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

Follow-up to [61678], [62656].

Props ramonopoly, westonruter, wildworks.
Fixes #65602.

File:

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

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

@@ -70 +70 @@
         if ( ! empty( $processed_css ) ) {
                 /**
-                 * 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).
+                 * Reuse one handle so identical custom CSS is enqueued only once via
+                 * {@see wp_unique_id_from_values()}. Explicitly declare the `wp-block-library`
+                 * dependency so `global-styles` is guaranteed to print after it, preventing
+                 * block default styles from unintentionally overriding global styles.
                  */
                 $handle = 'wp-block-custom-css';
                 if ( ! wp_style_is( $handle, 'registered' ) ) {
-                        wp_register_style( $handle, false, array( 'global-styles' ) );
+                        wp_register_style( $handle, false, array( 'wp-block-library', 'global-styles' ) );
                 }
                 $after_styles = wp_styles()->get_data( $handle, 'after' );