phpunit/block-supports/dimensions-test.php - trunk - githubmirror/gutenberg

phpunit/block-supports/dimensions-test.php
398 строк10 KB
tellthemachines
Add support for aspect ratio and related controls in viewport states (#78795)
12 июн 2026, 08:06
12 июн 2026, 08:060b846fc
<?php

/**
 * Test the dimensions block supports.
 *
 * @package gutenberg
 */

class WP_Block_Supports_Dimensions_Test extends WP_UnitTestCase {
	/**
	 * @var string|null
	 */
	private $test_block_name;

	public function set_up() {
		parent::set_up();
		$this->test_block_name = null;
	}

	public function tear_down() {
		unregister_block_type( $this->test_block_name );
		$this->test_block_name = null;
		parent::tear_down();
	}

	public function test_dimensions_style_is_applied() {
		$this->test_block_name = 'test/dimensions-style-is-applied';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'height'    => true,
						'minHeight' => true,
						'minWidth'  => true,
						'width'     => true,
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'height'    => '80vh',
					'minHeight' => '50vh',
					'minWidth'  => '200px',
					'width'     => '1000px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array(
			'style' => 'height:80vh;min-height:50vh;min-width:200px;width:1000px;',
		);

		$this->assertSame( $expected, $actual );
	}

	public function test_dimensions_with_skipped_serialization_block_supports() {
		$this->test_block_name = 'test/dimensions-with-skipped-serialization-block-supports';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'height'                          => true,
						'minHeight'                       => true,
						'width'                           => true,
						'__experimentalSkipSerialization' => true,
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'height'    => '70vh',
					'minHeight' => '50vh',
					'width'     => '999px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array();

		$this->assertSame( $expected, $actual );
	}

	public function test_min_height_with_individual_skipped_serialization_block_supports() {
		$this->test_block_name = 'test/min-height-with-individual-skipped-serialization-block-supports';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'minHeight'                       => true,
						'__experimentalSkipSerialization' => array( 'minHeight' ),
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'minHeight' => '50vh',
				),
			),
		);

		$actual = gutenberg_apply_dimensions_support( $block_type, $block_attrs );

		/*
		 * There is currently only one dimensions property available,
		 * so the expected result is an empty array. This test exists
		 * so that as new properties are added, this test can be expanded
		 * to check that skipping individual serialization works as expected.
		 */
		$expected = array();

		$this->assertSame( $expected, $actual );
	}

	public function test_width_style_is_applied() {
		$this->test_block_name = 'test/width-style-is-applied';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'width' => true,
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'width' => '300px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array(
			'style' => 'width:300px;',
		);

		$this->assertSame( $expected, $actual );
	}

	public function test_width_with_individual_skipped_serialization_block_supports() {
		$this->test_block_name = 'test/width-with-individual-skipped-serialization-block-supports';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'width'                           => true,
						'__experimentalSkipSerialization' => array( 'width' ),
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'width' => '300px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array();

		$this->assertSame( $expected, $actual );
	}

	public function test_height_style_is_applied() {
		$this->test_block_name = 'test/height-style-is-applied';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'height' => true,
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'height' => '400px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array(
			'style' => 'height:400px;',
		);

		$this->assertSame( $expected, $actual );
	}

	public function test_height_with_individual_skipped_serialization_block_supports() {
		$this->test_block_name = 'test/height-with-individual-skipped-serialization-block-supports';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'height'                          => true,
						'__experimentalSkipSerialization' => array( 'height' ),
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'height' => '400px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array();

		$this->assertSame( $expected, $actual );
	}

	public function test_min_width_style_is_applied() {
		$this->test_block_name = 'test/min-width-style-is-applied';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'minWidth' => true,
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'minWidth' => '200px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array(
			'style' => 'min-width:200px;',
		);

		$this->assertSame( $expected, $actual );
	}

	public function test_min_width_with_individual_skipped_serialization_block_supports() {
		$this->test_block_name = 'test/min-width-with-individual-skipped-serialization-block-supports';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'minWidth'                        => true,
						'__experimentalSkipSerialization' => array( 'minWidth' ),
					),
				),
			)
		);
		$registry    = WP_Block_Type_Registry::get_instance();
		$block_type  = $registry->get_registered( $this->test_block_name );
		$block_attrs = array(
			'style' => array(
				'dimensions' => array(
					'minWidth' => '200px',
				),
			),
		);

		$actual   = gutenberg_apply_dimensions_support( $block_type, $block_attrs );
		$expected = array();

		$this->assertSame( $expected, $actual );
	}

	public function test_default_aspect_ratio_does_not_unset_height_styles() {
		$this->test_block_name = 'test/default-aspect-ratio-does-not-unset-height-styles';
		register_block_type(
			$this->test_block_name,
			array(
				'api_version' => 3,
				'attributes'  => array(
					'style' => array(
						'type' => 'object',
					),
				),
				'supports'    => array(
					'dimensions' => array(
						'aspectRatio' => true,
					),
				),
			)
		);

		$actual = gutenberg_render_dimensions_support(
			'<div class="wp-block-test">Hello</div>',
			array(
				'blockName' => $this->test_block_name,
				'attrs'     => array(
					'style' => array(
						'dimensions' => array(
							'aspectRatio' => 'auto',
						),
					),
				),
			)
		);

		$this->assertStringNotContainsString( 'height:unset', $actual );
		$this->assertStringNotContainsString( 'min-height:unset', $actual );
	}
}