Changeset 51263

Timestamp:

06/29/2021 06:44:45 PM (2 years ago)

Author:

jorbin

Message:

Docs: Further Improve documentation for wp_should_load_separate_core_block_assets().

In [51256], the documentation was improved, this further improves it. As scripts are not yet a part of what this function does, they are not mentioned explicitly. Assets is used so that the docs don't need a lot of improvements when scripts do come into play..

Props desrosj, SergeyBiryukov, Jorbin.
See #53505.

File:

• trunk/src/wp-includes/script-loader.php (modified) (2 diffs)

trunk/src/wp-includes/script-loader.php

@@ -2327 +2327 @@
 
 /**
- * Checks whether separate assets should be loaded for core blocks on-render.
+ * Checks whether separate styles should be loaded for core blocks on-render.
  *
  * When this function returns true, other functions ensure that core blocks
- * only load their styles on-render, and each block loads its own, individual
- * stylesheet. Third-party blocks only load their styles when rendered.
- *
- * When this function returns false, all core block styles are loaded regardless
+ * only load their assets on-render, and each block loads its own, individual
+ * assets. Third-party blocks only load their assets when rendered.
+ *
+ * When this function returns false, all core block assets are loaded regardless
  * of whether they are rendered in a page or not, because they are all part of
- * the `block-library/style.css` file. Third-party blocks always get enqueued
- * regardless of whether they are rendered or not.
+ * the `block-library/style.css` file. Assets for third-party blocks are always
+ * enqueued regardless of whether they are rendered or not.
  *
  * This only affects front end and not the block editor screens.
@@ -2353 +2353 @@
 
     /**
-     * Filters the flag that decides whether separate scripts and styles
-     * will be loaded for core blocks on-render.
+     * Filters whether block styles should be loaded separately.
+     *
+     * Returning false loads all core block assets, regardless of whether they are rendered
+     * in a page or not. Returning true loads core block assets only when they are rendered.
      *
      * @since 5.8.0
      *
      * @param bool $load_separate_assets Whether separate assets will be loaded.
-     *                                   Default false.
+     *                                   Default false (all block assets are loaded, even when not used).
      */
     return apply_filters( 'should_load_separate_core_block_assets', false );