wp_should_load_block_assets_on_demand()
Checks whether block styles should be loaded only on-render.
When this function returns true, other functions ensure that blocks only load their assets on-render. When this function returns false, all block assets are loaded regardless of whether they are rendered in a page.
The default return value depends on the result of wp_should_load_separate_core_block_assets(), which controls whether Core block stylesheets should be loaded separately or via a combined 'wp-block-library' stylesheet.
This only affects front end and not the block editor screens.
Hooks from the function
Return
true|false. Whether to load block assets only when they are rendered.
Usage
wp_should_load_block_assets_on_demand();
Notes
Changelog
| Since 6.8.0 | Introduced. |
wp_should_load_block_assets_on_demand() wp should load block assets on demand code WP 6.8
function wp_should_load_block_assets_on_demand() {
if ( is_admin() || is_feed() || wp_is_rest_endpoint() ) {
return false;
}
/*
* For backward compatibility, the default return value for this function is based on the return value of
* `wp_should_load_separate_core_block_assets()`. Initially, this function used to control both of these concerns.
*/
$load_assets_on_demand = wp_should_load_separate_core_block_assets();
/**
* Filters whether block styles should be loaded on demand.
*
* Returning false loads all block assets, regardless of whether they are rendered in a page or not.
* Returning true loads block assets only when they are rendered.
*
* The default value of the filter depends on the result of {@see wp_should_load_separate_core_block_assets()},
* which controls whether Core block stylesheets should be loaded separately or via a combined 'wp-block-library'
* stylesheet.
*
* @since 6.8.0
*
* @param bool $load_assets_on_demand Whether to load block assets only when they are rendered.
*/
return apply_filters( 'should_load_block_assets_on_demand', $load_assets_on_demand );
}