Changeset 59925

Timestamp:

03/04/2025 01:04:49 PM (18 months ago)

Author:

Mamaduka

Message:

Block support: Add server-side processing for ariaLabel.

Adds server-side registration for ariaLabel block support and its required fields. Fully enabling feature support for dynamic blocks and consumers using ServerSideRender component.

Props wildworks, fabiankaegy, joemcgill, poena.
Fixes #62919.

Location:

trunk

Files:

• src/wp-includes/block-supports/aria-label.php (added)
• src/wp-includes/class-wp-block-supports.php (modified) (1 diff)
• src/wp-settings.php (modified) (1 diff)
• tests/phpunit/tests/block-supports/aria-label.php (added)
• tests/phpunit/tests/blocks/supportedStyles.php (modified) (2 diffs)

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

@@ -182 +182 @@
         // This is hardcoded on purpose.
         // We only support a fixed list of attributes.
-        $attributes_to_merge = array( 'style', 'class', 'id' );
+        $attributes_to_merge = array( 'style', 'class', 'id', 'aria-label' );
         $attributes          = array();
         foreach ( $attributes_to_merge as $attribute_name ) {

trunk/src/wp-settings.php

@@ -388 +388 @@
 require ABSPATH . WPINC . '/block-supports/background.php';
 require ABSPATH . WPINC . '/block-supports/block-style-variations.php';
+require ABSPATH . WPINC . '/block-supports/aria-label.php';
 require ABSPATH . WPINC . '/style-engine.php';
 require ABSPATH . WPINC . '/style-engine/class-wp-style-engine.php';

trunk/tests/phpunit/tests/blocks/supportedStyles.php

@@ -149 +149 @@
                         array_map( 'trim', explode( ';', $style_list ) ),
                         'Style list does not match expected styles'
+                );
+        }
+
+        /**
+         * Runs assertions that the rendered output has expected content and aria-label attr.
+         *
+         * @param array  $block               Block to render.
+         * @param string $expected_aria_label Expected output aria-label attr string.
+         */
+        private function assert_content_and_aria_label_match( $block, $expected_aria_label ) {
+                $styled_block = $this->render_example_block( $block );
+                $content      = $this->get_content_from_block( $styled_block );
+
+                $this->assertSame( self::BLOCK_CONTENT, $content, 'Block content does not match expected content' );
+                $this->assertSame(
+                        $expected_aria_label,
+                        $this->get_attribute_from_block( 'aria-label', $styled_block ),
+                        'Aria-label does not match expected aria-label'
                 );
         }
@@ -687 +705 @@
 
         /**
+         * Tests aria-label server-side block support.
+         */
+        public function test_aria_label_support() {
+                $block_type_settings = array(
+                        'attributes' => array(),
+                        'supports'   => array(
+                                'ariaLabel' => true,
+                        ),
+                );
+                $this->register_block_type( 'core/example', $block_type_settings );
+
+                $block = array(
+                        'blockName'    => 'core/example',
+                        'attrs'        => array(
+                                'ariaLabel' => 'Label',
+                        ),
+                        'innerBlock'   => array(),
+                        'innerContent' => array(),
+                        'innerHTML'    => array(),
+                );
+
+                $this->assert_content_and_aria_label_match( $block, 'Label' );
+        }
+
+        /**
          * Ensures libxml_internal_errors is being used instead of @ warning suppression
          */