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

Timestamp:

08/27/2025 03:41:36 PM (13 months ago)

Author:

Bernhard Reiter

Message:

Block Bindings: Allow generically setting rich-text block attributes.

Replace the existing block-specific, hard-coded, logic in the WP_Block class with more generic code that is able to locate and replace a rich-text sourced attribute based on the selector definition in its block.json.

This should make it easier to add block bindings support for more block attributes.

Props bernhard-reiter, jonsurrell, gziolo, cbravobernal, dmsnell.
Fixes #63840.

File:

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

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

@@ -417 +417 @@
                         case 'html':
                         case 'rich-text':
-                                $block_reader = new WP_HTML_Tag_Processor( $block_content );
+                                $block_reader = self::get_block_bindings_processor( $block_content );
 
                                 // TODO: Support for CSS selectors whenever they are ready in the HTML API.
@@ -425 +425 @@
                                 $block_reader->next_tag();
                                 $block_reader->set_bookmark( 'iterate-selectors' );
-
-                                // TODO: This shouldn't be needed when the `set_inner_html` function is ready.
-                                // Store the parent tag and its attributes to be able to restore them later in the button.
-                                // The button block has a wrapper while the paragraph and heading blocks don't.
-                                if ( 'core/button' === $this->name ) {
-                                        $button_wrapper                 = $block_reader->get_tag();
-                                        $button_wrapper_attribute_names = $block_reader->get_attribute_names_with_prefix( '' );
-                                        $button_wrapper_attrs           = array();
-                                        foreach ( $button_wrapper_attribute_names as $name ) {
-                                                $button_wrapper_attrs[ $name ] = $block_reader->get_attribute( $name );
-                                        }
-                                }
 
                                 foreach ( $selectors as $selector ) {
@@ -445 +433 @@
                                                 )
                                         ) ) {
+                                                // TODO: Use `WP_HTML_Processor::set_inner_html` method once it's available.
                                                 $block_reader->release_bookmark( 'iterate-selectors' );
-
-                                                // TODO: Use `set_inner_html` method whenever it's ready in the HTML API.
-                                                // Until then, it is hardcoded for the paragraph, heading, and button blocks.
-                                                // Store the tag and its attributes to be able to restore them later.
-                                                $selector_attribute_names = $block_reader->get_attribute_names_with_prefix( '' );
-                                                $selector_attrs           = array();
-                                                foreach ( $selector_attribute_names as $name ) {
-                                                        $selector_attrs[ $name ] = $block_reader->get_attribute( $name );
-                                                }
-                                                $selector_markup = "<$selector>" . wp_kses_post( $source_value ) . "</$selector>";
-                                                $amended_content = new WP_HTML_Tag_Processor( $selector_markup );
-                                                $amended_content->next_tag();
-                                                foreach ( $selector_attrs as $attribute_key => $attribute_value ) {
-                                                        $amended_content->set_attribute( $attribute_key, $attribute_value );
-                                                }
-                                                if ( 'core/paragraph' === $this->name || 'core/heading' === $this->name ) {
-                                                        return $amended_content->get_updated_html();
-                                                }
-                                                if ( 'core/button' === $this->name ) {
-                                                        $button_markup  = "<$button_wrapper>{$amended_content->get_updated_html()}</$button_wrapper>";
-                                                        $amended_button = new WP_HTML_Tag_Processor( $button_markup );
-                                                        $amended_button->next_tag();
-                                                        foreach ( $button_wrapper_attrs as $attribute_key => $attribute_value ) {
-                                                                $amended_button->set_attribute( $attribute_key, $attribute_value );
-                                                        }
-                                                        return $amended_button->get_updated_html();
-                                                }
+                                                $block_reader->replace_rich_text( wp_kses_post( $source_value ) );
+                                                return $block_reader->get_updated_html();
                                         } else {
                                                 $block_reader->seek( 'iterate-selectors' );
@@ -498 +462 @@
         }
 
+        private static function get_block_bindings_processor( string $block_content ) {
+                $internal_processor_class = new class('', WP_HTML_Processor::CONSTRUCTOR_UNLOCK_CODE) extends WP_HTML_Processor {
+                        /**
+                         * Replace the rich text content between a tag opener and matching closer.
+                         *
+                         * When stopped on a tag opener, replace the content enclosed by it and its
+                         * matching closer with the provided rich text.
+                         *
+                         * @param string $rich_text The rich text to replace the original content with.
+                         * @return bool True on success.
+                         */
+                        public function replace_rich_text( $rich_text ) {
+                                if ( $this->is_tag_closer() || ! $this->expects_closer() ) {
+                                        return false;
+                                }
+
+                                $depth = $this->get_current_depth();
+
+                                $this->set_bookmark( '_wp_block_bindings_tag_opener' );
+                                // The bookmark names are prefixed with `_` so the key below has an extra `_`.
+                                $tag_opener = $this->bookmarks['__wp_block_bindings_tag_opener'];
+                                $start      = $tag_opener->start + $tag_opener->length;
+                                $this->release_bookmark( '_wp_block_bindings_tag_opener' );
+
+                                // Find matching tag closer.
+                                while ( $this->next_token() && $this->get_current_depth() >= $depth ) {
+                                }
+
+                                $this->set_bookmark( '_wp_block_bindings_tag_closer' );
+                                $tag_closer  = $this->bookmarks['__wp_block_bindings_tag_closer'];
+                                $end         = $tag_closer->start;
+                                $this->release_bookmark( '_wp_block_bindings_tag_closer' );
+
+                                $this->lexical_updates[] = new WP_HTML_Text_Replacement(
+                                        $start,
+                                        $end - $start,
+                                        $rich_text
+                                );
+
+                                return true;
+                        }
+                };
+
+                return $internal_processor_class::create_fragment( $block_content );
+        }
 
         /**