enqueue_block_styles_assets()

Function responsible for enqueuing the styles required for block styles functionality on the editor and on the frontend.

Source

function enqueue_block_styles_assets() {
	global $wp_styles;

	$block_styles = WP_Block_Styles_Registry::get_instance()->get_all_registered();

	foreach ( $block_styles as $block_name => $styles ) {
		foreach ( $styles as $style_properties ) {
			if ( isset( $style_properties['style_handle'] ) ) {

				// If the site loads separate styles per-block, enqueue the stylesheet on render.
				if ( wp_should_load_separate_core_block_assets() ) {
					add_filter(
						'render_block',
						static function ( $html, $block ) use ( $block_name, $style_properties ) {
							if ( $block['blockName'] === $block_name ) {
								wp_enqueue_style( $style_properties['style_handle'] );
							}
							return $html;
						},
						10,
						2
					);
				} else {
					wp_enqueue_style( $style_properties['style_handle'] );
				}
			}
			if ( isset( $style_properties['inline_style'] ) ) {

				// Default to "wp-block-library".
				$handle = 'wp-block-library';

				// If the site loads separate styles per-block, check if the block has a stylesheet registered.
				if ( wp_should_load_separate_core_block_assets() ) {
					$block_stylesheet_handle = generate_block_asset_handle( $block_name, 'style' );

					if ( isset( $wp_styles->registered[ $block_stylesheet_handle ] ) ) {
						$handle = $block_stylesheet_handle;
					}
				}

				// Add inline styles to the calculated handle.
				wp_add_inline_style( $handle, $style_properties['inline_style'] );
			}
		}
	}
}

View all references View on Trac View on GitHub

Uses	Description
wp_should_load_separate_core_block_assets()`wp-includes/script-loader.php`	Checks whether separate styles should be loaded for core blocks on-render.
generate_block_asset_handle()`wp-includes/blocks.php`	Generates the name for an asset based on the name of the block and the field name provided.
WP_Block_Styles_Registry::get_instance()`wp-includes/class-wp-block-styles-registry.php`	Utility method to retrieve the main instance of the class.
wp_enqueue_style()`wp-includes/functions.wp-styles.php`	Enqueues a CSS stylesheet.
wp_add_inline_style()`wp-includes/functions.wp-styles.php`	Adds extra CSS styles to a registered stylesheet.
add_filter()`wp-includes/plugin.php`	Adds a callback function to a filter hook.

Show 1 more Show less

Changelog

Version	Description
5.3.0	Introduced.

User Contributed Notes

Skip to note 2 content

Will Skora 2 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
If you want opt-out of loading CSS for the core blocks, loaded in the wp-block-library stylesheet, you can do so by the following:
```
function mytheme_block_assets() {
	wp_deregister_style( 'wp-block-library' );
	wp_register_style( 'wp-block-library', '' );
}
add_action( 'enqueue_block_assets', 'mytheme_block_assets' );
```
(credit to Adam Jacobi and Brad Thomason )
Log in to add feedback

In this article

Source

Related

Changelog

User Contributed Notes