wp_hoist_late_printed_styles()

Uses · 19

• is_embed()Is the query for an embedded post?
• wp_styles()Initializes $wp_styles if it has not been set.
• wp_add_inline_style()Adds extra CSS styles to a registered stylesheet.
• str_starts_with()Polyfill for `str_starts_with()` function added in PHP 8.0.
• wp_style_is()Checks whether a CSS stylesheet has been added to the queue.
• has_action()Checks if any action has been registered for a hook.
• add_action()Adds a callback function to an action hook.
• remove_action()Removes a callback function from an action hook.
• print_footer_scripts()Prints the scripts that were queued for the footer or too late for the HTML head.
• add_filter()Adds a callback function to a filter hook.
• esc_url_raw()Sanitizes a URL for database or redirect usage.
• wp_styles()::query()

Source

View on Trac ↗View on GitHub ↗

3737function wp_hoist_late_printed_styles(): void {3738	// Skip the embed template on-demand styles aren't relevant, and there is no wp_head action.3739	if ( is_embed() ) {3740		return;3741	}3742 3743	/*3744	 * Add a placeholder comment into the inline styles for wp-block-library, after which the late block styles3745	 * can be hoisted from the footer to be printed in the header by means of a filter below on the template enhancement3746	 * output buffer.3747	 *3748	 * Note that wp_maybe_inline_styles() prepends the inlined style to the extra 'after' array, which happens after3749	 * this code runs. This ensures that the placeholder appears right after any inlined wp-block-library styles,3750	 * which would be common.css.3751	 */3752	$placeholder = sprintf( '/*%s*/', uniqid( 'wp_block_styles_on_demand_placeholder:' ) );3753	$dependency  = wp_styles()->query( 'wp-block-library', 'registered' );3754	if ( $dependency ) {3755		if ( ! isset( $dependency->extra['after'] ) ) {3756			wp_add_inline_style( 'wp-block-library', $placeholder );3757		} else {3758			array_unshift( $dependency->extra['after'], $placeholder );3759		}3760	}3761 3762	/*3763	 * Create a substitute for `print_late_styles()` which is aware of block styles. This substitute does not print3764	 * the styles, but it captures what would be printed for block styles and non-block styles so that they can be3765	 * later hoisted to the HEAD in the template enhancement output buffer. This will run at `wp_print_footer_scripts`3766	 * before `print_footer_scripts()` is called.3767	 */3768	$printed_core_block_styles  = '';3769	$printed_other_block_styles = '';3770	$printed_global_styles      = '';3771	$printed_late_styles        = '';3772 3773	$capture_late_styles = static function () use ( &$printed_core_block_styles, &$printed_other_block_styles, &$printed_global_styles, &$printed_late_styles ) {3774		// Gather the styles related to on-demand block enqueues.3775		$all_core_block_style_handles  = array();3776		$all_other_block_style_handles = array();3777		foreach ( WP_Block_Type_Registry::get_instance()->get_all_registered() as $block_type ) {3778			if ( str_starts_with( $block_type->name, 'core/' ) ) {3779				foreach ( $block_type->style_handles as $style_handle ) {3780					$all_core_block_style_handles[] = $style_handle;3781				}3782			} else {3783				foreach ( $block_type->style_handles as $style_handle ) {3784					$all_other_block_style_handles[] = $style_handle;3785				}3786			}3787		}3788 3789		/*3790		 * First print all styles related to core blocks which should be inserted right after the wp-block-library stylesheet3791		 * to preserve the CSS cascade. The logic in this `if` statement is derived from `wp_print_styles()`.3792		 */3793		$enqueued_core_block_styles = array_values( array_intersect( $all_core_block_style_handles, wp_styles()->queue ) );3794		if ( count( $enqueued_core_block_styles ) > 0 ) {3795			ob_start();3796			wp_styles()->do_items( $enqueued_core_block_styles );3797			$printed_core_block_styles = (string) ob_get_clean();3798		}3799 3800		// Capture non-core block styles so they can get printed at the point where wp_enqueue_registered_block_scripts_and_styles() runs.3801		$enqueued_other_block_styles = array_values( array_intersect( $all_other_block_style_handles, wp_styles()->queue ) );3802		if ( count( $enqueued_other_block_styles ) > 0 ) {3803			ob_start();3804			wp_styles()->do_items( $enqueued_other_block_styles );3805			$printed_other_block_styles = (string) ob_get_clean();3806		}3807 3808		// Capture the global-styles so that it can be printed at the point where wp_enqueue_global_styles() runs.3809		if ( wp_style_is( 'global-styles' ) ) {3810			ob_start();3811			wp_styles()->do_items( array( 'global-styles' ) );3812			$printed_global_styles = (string) ob_get_clean();3813		}3814 3815		/*3816		 * Print all remaining styles not related to blocks. This contains a subset of the logic from

History

Introduced in 6.9.0. Unchanged from 6.9.7 through 7.1.0.

1. 6.9.7
2. 7.0.4
3. 7.1.0

Signature, return type and hooks compared across 3 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/script-loader.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.