Changeset 61019 for trunk/src/wp-includes/blocks.php

Timestamp:

10/21/2025 11:30:43 AM (4 months ago)

Author:

luisherranz

Message:

Interactivity API: Support for loadOnClientNavigation.

Uses the wp_script_attributes filter to add a data-wp-router-options directive with a loadOnClientNavigation: true property for all the interactive blocks that are compatible with client-side navigation to let the Interactivity API router determine which modules it can safely load during client-side navigation.

Props luisherranz, westonruter.
Fixes #64122.

File:

• trunk/src/wp-includes/blocks.php (modified) (1 diff)

trunk/src/wp-includes/blocks.php

@@ -176 +176 @@
     $module_version      = isset( $module_asset['version'] ) ? $module_asset['version'] : $block_version;
 
-    // Blocks using the Interactivity API are server-side rendered, so they are by design not in the critical rendering path and should be deprioritized.
+    $supports_interactivity_true = isset( $metadata['supports']['interactivity'] ) && true === $metadata['supports']['interactivity'];
+    $is_interactive              = $supports_interactivity_true || ( isset( $metadata['supports']['interactivity']['interactive'] ) && true === $metadata['supports']['interactivity']['interactive'] );
+    $supports_client_navigation  = $supports_interactivity_true || ( isset( $metadata['supports']['interactivity']['clientNavigation'] ) && true === $metadata['supports']['interactivity']['clientNavigation'] );
+
     $args = array();
-    if (
-        ( isset( $metadata['supports']['interactivity'] ) && true === $metadata['supports']['interactivity'] ) ||
-        ( isset( $metadata['supports']['interactivity']['interactive'] ) && true === $metadata['supports']['interactivity']['interactive'] )
-    ) {
+
+    // Blocks using the Interactivity API are server-side rendered, so they are
+    // by design not in the critical rendering path and should be deprioritized.
+    if ( $is_interactive ) {
         $args['fetchpriority'] = 'low';
         $args['in_footer']     = true;
+    }
+
+    // Blocks using the Interactivity API that support client-side navigation
+    // must be marked as such in their script modules.
+    if ( $is_interactive && $supports_client_navigation ) {
+        wp_interactivity()->add_client_navigation_support_to_script_module( $module_id );
     }