Changeset 60611 for trunk/src/wp-includes/class-wp-block.php

Timestamp:

08/06/2025 06:20:22 PM (13 months ago)

Author:

Bernhard Reiter

Message:

Block Bindings: Add filter to set supported block attributes.

Add a new filter, block_bindings_supported_attributes_{$block_type}, that allows customizing which of a block's attributes can be connected to a Block Bindings source.

Props bernhard-reiter, gziolo, maxschmeling.
Closes #62090.

File:

• trunk/src/wp-includes/class-wp-block.php (modified) (5 diffs)

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' ),
+                'core/button'    => array( 'url', 'text', 'linkTarget', 'rel' ),
+                'core/post-date' => array( 'datetime' ),
+        );
 
         /**
@@ -279 +295 @@
          */
         private function process_block_bindings() {
+                $block_type                 = $this->name;
                 $parsed_block               = $this->parsed_block;
                 $computed_attributes        = array();
-                $supported_block_attributes = array(
-                        'core/paragraph' => array( 'content' ),
-                        'core/heading'   => array( 'content' ),
-                        'core/image'     => array( 'id', 'url', 'title', 'alt' ),
-                        'core/button'    => array( 'url', 'text', 'linkTarget', 'rel' ),
-                        'core/post-date' => array( 'datetime' ),
+
+                $supported_block_attributes =
+                        self::BLOCK_BINDINGS_SUPPORTED_ATTRIBUTES[ $block_type ] ??
+                        array();
+
+                /**
+                 * 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
                 );
 
@@ -292 +321 @@
                 // block types, or the bindings property is not an array, return the block content.
                 if (
-                        ! isset( $supported_block_attributes[ $this->name ] ) ||
+                        empty( $supported_block_attributes ) ||
                         empty( $parsed_block['attrs']['metadata']['bindings'] ) ||
                         ! is_array( $parsed_block['attrs']['metadata']['bindings'] )
@@ -316 +345 @@
                          * resulting array.
                          */
-                        foreach ( $supported_block_attributes[ $parsed_block['blockName'] ] as $attribute_name ) {
+                        foreach ( $supported_block_attributes as $attribute_name ) {
                                 // Retain any non-pattern override bindings that might be present.
                                 $updated_bindings[ $attribute_name ] = isset( $bindings[ $attribute_name ] )
@@ -335 +364 @@
                 foreach ( $bindings as $attribute_name => $block_binding ) {
                         // If the attribute is not in the supported list, process next attribute.
-                        if ( ! in_array( $attribute_name, $supported_block_attributes[ $this->name ], true ) ) {
+                        if ( ! in_array( $attribute_name, $supported_block_attributes, true ) ) {
                                 continue;
                         }