Changeset 60807

Timestamp:

09/29/2025 08:57:51 AM (10 days ago)

Author:

Bernhard Reiter

Message:

Block Bindings: Communicate supported block attributes from server.

Instead of requiring the client side to keep a separate list of block attributes that are supported by Block Bindings, communicate that list from the server -- including block attributes that were added there via the block_bindings_supported_attributes filter.

Props bernhard-reiter, mukesh27, gziolo.
Fixes #64030.

Location:

trunk/src/wp-includes

Files:

• block-bindings.php (modified) (1 diff)
• block-editor.php (modified) (1 diff)
• class-wp-block.php (modified) (2 diffs)

trunk/src/wp-includes/block-bindings.php

@@ -130 +130 @@
     return WP_Block_Bindings_Registry::get_instance()->get_registered( $source_name );
 }
+
+/**
+ * Retrieves the list of block attributes supported by block bindings.
+ *
+ * @since 6.9.0
+ *
+ * @param string $block_type The block type whose supported attributes are being retrieved.
+ * @return array The list of block attributes that are supported by block bindings.
+ */
+function get_block_bindings_supported_attributes( $block_type ) {
+    $block_bindings_supported_attributes = array(
+        'core/paragraph' => array( 'content' ),
+        'core/heading'   => array( 'content' ),
+        'core/image'     => array( 'id', 'url', 'title', 'alt', 'caption' ),
+        'core/button'    => array( 'url', 'text', 'linkTarget', 'rel' ),
+        'core/post-date' => array( 'datetime' ),
+    );
+
+    $supported_block_attributes =
+        $block_bindings_supported_attributes[ $block_type ] ??
+        array();
+
+    /**
+     * Filters the supported block attributes for block bindings.
+     *
+     * @since 6.9.0
+     *
+     * @param string[] $supported_block_attributes The block's attributes that are supported by block bindings.
+     * @param string   $block_type                 The block type whose attributes are being filtered.
+     */
+    $supported_block_attributes = apply_filters(
+        'block_bindings_supported_attributes',
+        $supported_block_attributes,
+        $block_type
+    );
+
+    /**
+     * Filters the supported block attributes for block bindings.
+     *
+     * The dynamic portion of the hook name, `$block_type`, refers to the block type
+     * whose attributes are being filtered.
+     *
+     * @since 6.9.0
+     *
+     * @param string[] $supported_block_attributes The block's attributes that are supported by block bindings.
+     */
+    $supported_block_attributes = apply_filters(
+        "block_bindings_supported_attributes_{$block_type}",
+        $supported_block_attributes
+    );
+
+    return $supported_block_attributes;
+}

trunk/src/wp-includes/block-editor.php

@@ -496 +496 @@
         $custom_settings
     );
+
+    $editor_settings['__experimentalBlockBindingsSupportedAttributes'] = array();
+    foreach ( array_keys( WP_Block_Type_Registry::get_instance()->get_all_registered() ) as $block_type ) {
+        $supported_block_attributes = get_block_bindings_supported_attributes( $block_type );
+        if ( ! empty( $supported_block_attributes ) ) {
+            $editor_settings['__experimentalBlockBindingsSupportedAttributes'][ $block_type ] = $supported_block_attributes;
+        }
+    }
 
     $global_styles = array();

trunk/src/wp-includes/class-wp-block.php

@@ -98 +98 @@
      */
     public $inner_content = array();
-
-    /**
-     * List of supported block attributes for block bindings.
-     *
-     * @since 6.9.0
-     * @var array
-     *
-     * @see WP_Block::process_block_bindings()
-     */
-    private const BLOCK_BINDINGS_SUPPORTED_ATTRIBUTES = array(
-        'core/paragraph' => array( 'content' ),
-        'core/heading'   => array( 'content' ),
-        'core/image'     => array( 'id', 'url', 'title', 'alt', 'caption' ),
-        'core/button'    => array( 'url', 'text', 'linkTarget', 'rel' ),
-        'core/post-date' => array( 'datetime' ),
-    );
 
     /**
@@ -298 +282 @@
         $parsed_block               = $this->parsed_block;
         $computed_attributes        = array();
-        $supported_block_attributes =
-            self::BLOCK_BINDINGS_SUPPORTED_ATTRIBUTES[ $block_type ] ??
-            array();
-
-        /**
-         * Filters the supported block attributes for block bindings.
-         *
-         * @since 6.9.0
-         *
-         * @param string[] $supported_block_attributes The block's attributes that are supported by block bindings.
-         * @param string   $block_type                 The block type whose attributes are being filtered.
-         */
-        $supported_block_attributes = apply_filters(
-            'block_bindings_supported_attributes',
-            $supported_block_attributes,
-            $block_type
-        );
-
-        /**
-         * Filters the supported block attributes for block bindings.
-         *
-         * The dynamic portion of the hook name, `$block_type`, refers to the block type
-         * whose attributes are being filtered.
-         *
-         * @since 6.9.0
-         *
-         * @param string[] $supported_block_attributes The block's attributes that are supported by block bindings.
-         */
-        $supported_block_attributes = apply_filters(
-            "block_bindings_supported_attributes_{$block_type}",
-            $supported_block_attributes
-        );
+        $supported_block_attributes = get_block_bindings_supported_attributes( $block_type );
 
         // If the block doesn't have the bindings property, isn't one of the supported