Changeset 61619

Timestamp:

02/12/2026 05:06:08 AM (3 weeks ago)

Author:

ramonopoly

Message:

Block Supports: Add width to dimensions supports

This PR introduces dimensions.width to the list of available block supports.

This block support enables, in the future, the removal of the custom width and height controls in blocks such as Button, Column and many others in favor of customizations via block supports.

Props aaronrobertshaw, andrewserong, ramonopoly, welcher, mamaduka, wildworks, youknowriad, isabel_brison.

Fixes #64200.

Location:

trunk

Files:

• src/wp-includes/block-supports/dimensions.php (modified) (2 diffs)
• src/wp-includes/class-wp-theme-json.php (modified) (10 diffs)
• src/wp-includes/style-engine/class-wp-style-engine.php (modified) (1 diff)
• tests/phpunit/tests/block-supports/wpApplyDimensionsSupport.php (modified) (1 diff)
• tests/phpunit/tests/theme/wpThemeJson.php (modified) (2 diffs)

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

@@ -52 +52 @@
  */
 function wp_apply_dimensions_support( $block_type, $block_attributes ) {
+
+
     if ( wp_should_skip_block_supports_serialization( $block_type, 'dimensions' ) ) {
-        return array();
+        return ;
     }
 
-    $attributes = array();
-
-    // Width support to be added in near future.
-
-    $has_min_height_support = block_has_support( $block_type, array( 'dimensions', 'minHeight' ), false );
-    $block_styles           = $block_attributes['style'] ?? null;
+    $block_styles = $block_attributes['style'] ?? null;
 
     if ( ! $block_styles ) {
@@ -67 +64 @@
     }
 
-    $skip_min_height                      = wp_should_skip_block_supports_serialization( $block_type, 'dimensions', 'minHeight' );
-    $dimensions_block_styles              = array();
-    $dimensions_block_styles['minHeight'] = null;
-    if ( $has_min_height_support && ! $skip_min_height ) {
-        $dimensions_block_styles['minHeight'] = $block_styles['dimensions']['minHeight'] ?? null;
+    $dimensions_block_styles = array();
+    $supported_features      = array( 'minHeight', 'width' );
+
+    foreach ( $supported_features as $feature ) {
+        $has_support        = block_has_support( $block_type, array( 'dimensions', $feature ), false );
+        $skip_serialization = wp_should_skip_block_supports_serialization( $block_type, 'dimensions', $feature );
+
+        $dimensions_block_styles[ $feature ] = null;
+
+        if ( $has_support && ! $skip_serialization ) {
+            $dimensions_block_styles[ $feature ] = $block_styles['dimensions'][ $feature ] ?? null;
+        }
     }
+
     $styles = wp_style_engine_get_styles( array( 'dimensions' => $dimensions_block_styles ) );
 

trunk/src/wp-includes/class-wp-theme-json.php

@@ -238 +238 @@
      * @since 6.6.0 Added `background-[image|position|repeat|size]` properties.
      * @since 6.7.0 Added `background-attachment` property.
+
      * @var array
      */
@@ -302 +303 @@
         'filter'                            => array( 'filter', 'duotone' ),
         'box-shadow'                        => array( 'shadow' ),
+
         'writing-mode'                      => array( 'typography', 'writingMode' ),
     );
@@ -397 +399 @@
      * @since 6.9.0 Added support for `border.radiusSizes`.
      * @since 7.0.0 Added type markers to the schema for boolean values.
+
      * @var array
      */
@@ -436 +439 @@
             'defaultAspectRatios' => null,
             'minHeight'           => null,
+
         ),
         'layout'                        => array(
@@ -529 +533 @@
      * @since 6.5.0 Added support for `dimensions.aspectRatio`.
      * @since 6.6.0 Added `background` sub properties to top-level only.
+
      * @var array
      */
@@ -557 +562 @@
             'aspectRatio' => null,
             'minHeight'   => null,
+
         ),
         'filter'     => array(
@@ -656 +662 @@
      *
      * @since 6.1.0
+
      * @var string[]
      */
@@ -661 +668 @@
         '__experimentalBorder' => 'border',
         'color'                => 'color',
+
         'spacing'              => 'spacing',
         'typography'           => 'typography',
@@ -765 +773 @@
      * @since 6.4.0 Added `background.backgroundImage`.
      * @since 6.5.0 Added `background.backgroundSize` and `dimensions.aspectRatio`.
+
      * @var array
      */
@@ -780 +789 @@
         array( 'dimensions', 'aspectRatio' ),
         array( 'dimensions', 'minHeight' ),
+
         array( 'position', 'sticky' ),
         array( 'spacing', 'blockGap' ),

trunk/src/wp-includes/style-engine/class-wp-style-engine.php

@@ -220 +220 @@
                 ),
             ),
+
+
+
+
+
+
         ),
         'spacing'    => array(

trunk/tests/phpunit/tests/block-supports/wpApplyDimensionsSupport.php

@@ -101 +101 @@
         );
     }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 }

trunk/tests/phpunit/tests/theme/wpThemeJson.php

@@ -282 +282 @@
                 'aspectRatio' => true,
                 'minHeight'   => true,
+
             ),
             'position'   => array(
@@ -321 +322 @@
                         'aspectRatio' => true,
                         'minHeight'   => true,
+
                     ),
                     'position'   => array(