Introduce enqueue_empty_block_content_assets filter

westonruter · westonruter · commit f3209f6bad21 · 2025-07-28T18:26:05.000-07:00
diff --git a/src/wp-includes/class-wp-block.php b/src/wp-includes/class-wp-block.php
@@ -632,7 +632,16 @@ public function render( $options = array() ) {
 		 * In all these cases, adding scripts and styles will be a waste since they will not be used on the page.
 		 */
 		$processor = new WP_HTML_Tag_Processor( $block_content );
-		if ( $processor->next_tag() ) {
+
+		/**
+		 * Filters whether to enqueue assets for a block which has no rendered content.
+		 *
+		 * @since 6.9.0
+		 *
+		 * @param bool   $enqueue    Whether to enqueue assets.
+		 * @param string $block_name Block name.
+		 */
+		if ( (bool) apply_filters( 'enqueue_empty_block_content_assets', $processor->next_tag(), $this->name ) ) {
 			if ( ( ! empty( $this->block_type->script_handles ) ) ) {
 				foreach ( $this->block_type->script_handles as $script_handle ) {
 					wp_enqueue_script( $script_handle );
diff --git a/src/wp-includes/script-loader.php b/src/wp-includes/script-loader.php
@@ -2739,7 +2739,8 @@ static function ( $html, $block ) use ( $block_name, $style_properties ) {
 							if ( $block['blockName'] === $block_name ) {
 								// If the block didn't render any tags, then do not enqueue any styles. Rendering just an HTML comment is also excluded.
 								$processor = new WP_HTML_Tag_Processor( $html );
-								if ( $processor->next_tag() ) {
+									/** This filter is documented in src/wp-includes/class-wp-block.php */
+									if ( (bool) apply_filters( 'enqueue_empty_block_content_assets', $processor->next_tag(), $block_name ) ) {
 									wp_enqueue_style( $style_properties['style_handle'] );
 								}
 							}
@@ -3295,11 +3296,12 @@ function wp_enqueue_block_style( $block_name, $args ) {
 	 *                        is to ensure the content exists.
 	 * @return string Block content.
 	 */
-	$callback = static function ( $content ) use ( $args ) {
+	$callback = static function ( $content ) use ( $block_name, $args ) {
 
 		// If the block didn't render any tags, then do not enqueue any styles. Rendering just an HTML comment is also excluded.
 		$processor = new WP_HTML_Tag_Processor( $content );
-		if ( ! $processor->next_tag() ) {
+		/** This filter is documented in src/wp-includes/class-wp-block.php */
+		if ( ! (bool) apply_filters( 'enqueue_empty_block_content_assets', $processor->next_tag(), $block_name ) ) {
 			return $content;
 		}
 
