Changeset 59925

Timestamp:

03/04/2025 01:04:49 PM (6 weeks 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
      */