class ElementTest

Same name in this branch
  1. 9 core/modules/system/tests/src/Functional/Form/ElementTest.php \Drupal\Tests\system\Functional\Form\ElementTest
Same name and namespace in other branches
  1. 8.9.x core/modules/system/tests/src/Functional/Form/ElementTest.php \Drupal\Tests\system\Functional\Form\ElementTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Render/ElementTest.php \Drupal\Tests\Core\Render\ElementTest
  3. 10 core/modules/system/tests/src/Functional/Form/ElementTest.php \Drupal\Tests\system\Functional\Form\ElementTest
  4. 10 core/tests/Drupal/Tests/Core/Render/ElementTest.php \Drupal\Tests\Core\Render\ElementTest
  5. 11.x core/modules/system/tests/src/Functional/Form/ElementTest.php \Drupal\Tests\system\Functional\Form\ElementTest
  6. 11.x core/tests/Drupal/Tests/Core/Render/ElementTest.php \Drupal\Tests\Core\Render\ElementTest

@coversDefaultClass \Drupal\Core\Render\Element @group Render

Hierarchy

Expanded class hierarchy of ElementTest

File

core/tests/Drupal/Tests/Core/Render/ElementTest.php, line 13

Namespace

Drupal\Tests\Core\Render
View source 
class ElementTest extends UnitTestCase {
    
    /**
     * Tests the property() method.
     */
    public function testProperty() {
        $this->assertTrue(Element::property('#property'));
        $this->assertFalse(Element::property('property'));
        $this->assertFalse(Element::property('property#'));
        $this->assertFalse(Element::property(0));
    }
    
    /**
     * Tests the properties() method.
     */
    public function testProperties() {
        $element = [
            '#property1' => 'property1',
            '#property2' => 'property2',
            'property3' => 'property3',
            0 => [],
        ];
        $properties = Element::properties($element);
        $this->assertSame([
            '#property1',
            '#property2',
        ], $properties);
    }
    
    /**
     * Tests the child() method.
     */
    public function testChild() {
        $this->assertFalse(Element::child('#property'));
        $this->assertTrue(Element::child('property'));
        $this->assertTrue(Element::child('property#'));
    }
    
    /**
     * Tests the children() method.
     */
    public function testChildren() {
        $element = [
            'child2' => [
                '#weight' => 10,
            ],
            'child1' => [
                '#weight' => 0,
            ],
            'child3' => [
                '#weight' => 20,
            ],
            '#property' => 'property',
        ];
        $expected = [
            'child2',
            'child1',
            'child3',
        ];
        $element_copy = $element;
        $this->assertSame($expected, Element::children($element_copy));
        // If #sorted is already set, no sorting should happen.
        $element_copy = $element;
        $element_copy['#sorted'] = TRUE;
        $expected = [
            'child2',
            'child1',
            'child3',
        ];
        $this->assertSame($expected, Element::children($element_copy, TRUE));
        // Test with weight sorting, #sorted property should be added.
        $expected = [
            'child1',
            'child2',
            'child3',
        ];
        $element_copy = $element;
        $this->assertSame($expected, Element::children($element_copy, TRUE));
        $this->assertArrayHasKey('#sorted', $element_copy);
        $this->assertTrue($element_copy['#sorted']);
        // The order should stay the same if no weights present.
        $element_no_weight = [
            'child2' => [],
            'child1' => [],
            'child3' => [],
            '#property' => 'property',
        ];
        $expected = [
            'child2',
            'child1',
            'child3',
        ];
        $this->assertSame($expected, Element::children($element_no_weight, TRUE));
        // The order of children with same weight should be preserved.
        $element_mixed_weight = [
            'child5' => [
                '#weight' => 10,
            ],
            'child3' => [
                '#weight' => -10,
            ],
            'child1' => [],
            'child4' => [
                '#weight' => 10,
            ],
            'child2' => [],
        ];
        $expected = [
            'child3',
            'child1',
            'child2',
            'child5',
            'child4',
        ];
        $this->assertSame($expected, Element::children($element_mixed_weight, TRUE));
    }
    
    /**
     * Tests the children() method with an invalid key.
     */
    public function testInvalidChildren() {
        $element = [
            'foo' => 'bar',
        ];
        $this->expectError();
        $this->expectErrorMessage('"foo" is an invalid render array key');
        Element::children($element);
    }
    
    /**
     * Tests the children() method with an ignored key/value pair.
     */
    public function testIgnoredChildren() {
        $element = [
            'foo' => NULL,
        ];
        $this->assertSame([], Element::children($element));
    }
    
    /**
     * Tests the visibleChildren() method.
     *
     * @param array $element
     *   The test element array.
     * @param array $expected_keys
     *   The expected keys to be returned from Element::getVisibleChildren().
     *
     * @dataProvider providerVisibleChildren
     */
    public function testVisibleChildren(array $element, array $expected_keys) {
        $this->assertSame($expected_keys, Element::getVisibleChildren($element));
    }
    
    /**
     * Data provider for testVisibleChildren.
     *
     * @return array
     */
    public function providerVisibleChildren() {
        return [
            [
                [
                    '#property1' => '',
                    '#property2' => [],
                ],
                [],
            ],
            [
                [
                    '#property1' => '',
                    'child1' => [],
                ],
                [
                    'child1',
                ],
            ],
            [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#access' => TRUE,
                    ],
                ],
                [
                    'child1',
                    'child2',
                ],
            ],
            [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#access' => FALSE,
                    ],
                ],
                [
                    'child1',
                ],
            ],
            'access_result_object_allowed' => [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#access' => AccessResult::allowed(),
                    ],
                ],
                [
                    'child1',
                    'child2',
                ],
            ],
            'access_result_object_forbidden' => [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#access' => AccessResult::forbidden(),
                    ],
                ],
                [
                    'child1',
                ],
            ],
            [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#type' => 'textfield',
                    ],
                ],
                [
                    'child1',
                    'child2',
                ],
            ],
            [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#type' => 'value',
                    ],
                ],
                [
                    'child1',
                ],
            ],
            [
                [
                    '#property1' => '',
                    'child1' => [],
                    'child2' => [
                        '#type' => 'hidden',
                    ],
                ],
                [
                    'child1',
                ],
            ],
        ];
    }
    
    /**
     * Tests the setAttributes() method.
     *
     * @dataProvider providerTestSetAttributes
     */
    public function testSetAttributes($element, $map, $expected_element) {
        Element::setAttributes($element, $map);
        $this->assertSame($expected_element, $element);
    }
    
    /**
     * Data provider for testSetAttributes().
     */
    public function providerTestSetAttributes() {
        $base = [
            '#id' => 'id',
            '#class' => [],
        ];
        return [
            [
                $base,
                [],
                $base,
            ],
            [
                $base,
                [
                    'id',
                    'class',
                ],
                $base + [
                    '#attributes' => [
                        'id' => 'id',
                        'class' => [],
                    ],
                ],
            ],
            [
                $base + [
                    '#attributes' => [
                        'id' => 'id-not-overwritten',
                    ],
                ],
                [
                    'id',
                    'class',
                ],
                $base + [
                    '#attributes' => [
                        'id' => 'id-not-overwritten',
                        'class' => [],
                    ],
                ],
            ],
        ];
    }
    
    /**
     * @covers ::isEmpty
     *
     * @dataProvider providerTestIsEmpty
     */
    public function testIsEmpty(array $element, $expected) {
        $this->assertSame(Element::isEmpty($element), $expected);
    }
    public function providerTestIsEmpty() {
        return [
            [
                [],
                TRUE,
            ],
            [
                [
                    '#attached' => [],
                ],
                FALSE,
            ],
            [
                [
                    '#cache' => [],
                ],
                TRUE,
            ],
            [
                [
                    '#weight' => [],
                ],
                TRUE,
            ],
            // Variations.
[
                [
                    '#attached' => [],
                    '#cache' => [],
                ],
                FALSE,
            ],
            [
                [
                    '#attached' => [],
                    '#weight' => [],
                ],
                FALSE,
            ],
            [
                [
                    '#attached' => [],
                    '#weight' => [],
                    '#cache' => [],
                ],
                FALSE,
            ],
            [
                [
                    '#cache' => [],
                    '#weight' => [],
                ],
                TRUE,
            ],
            [
                [
                    '#cache' => [],
                    '#weight' => [],
                    '#any_other_property' => [],
                ],
                FALSE,
            ],
            [
                [
                    '#attached' => [],
                    '#weight' => [],
                    '#cache' => [],
                    '#any_other_property' => [],
                ],
                FALSE,
            ],
            // Cover sorting.
[
                [
                    '#cache' => [],
                    '#weight' => [],
                    '#attached' => [],
                ],
                FALSE,
            ],
            [
                [
                    '#cache' => [],
                    '#weight' => [],
                ],
                TRUE,
            ],
            [
                [
                    '#weight' => [],
                    '#cache' => [],
                ],
                TRUE,
            ],
            [
                [
                    '#cache' => [],
                ],
                TRUE,
            ],
            [
                [
                    '#cache' => [
                        'tags' => [
                            'foo',
                        ],
                    ],
                ],
                TRUE,
            ],
            [
                [
                    '#cache' => [
                        'contexts' => [
                            'bar',
                        ],
                    ],
                ],
                TRUE,
            ],
            [
                [
                    '#cache' => [],
                    '#markup' => 'llamas are awesome',
                ],
                FALSE,
            ],
            [
                [
                    '#markup' => 'llamas are the most awesome ever',
                ],
                FALSE,
            ],
            [
                [
                    '#cache' => [],
                    '#any_other_property' => TRUE,
                ],
                FALSE,
            ],
            [
                [
                    '#any_other_property' => TRUE,
                ],
                FALSE,
            ],
        ];
    }

}

Members

Title Deprecated Modifiers Object type Summary Overrides
ElementTest::providerTestIsEmpty public function
ElementTest::providerTestSetAttributes public function Data provider for testSetAttributes().
ElementTest::providerVisibleChildren public function Data provider for testVisibleChildren.
ElementTest::testChild public function Tests the child() method.
ElementTest::testChildren public function Tests the children() method.
ElementTest::testIgnoredChildren public function Tests the children() method with an ignored key/value pair.
ElementTest::testInvalidChildren public function Tests the children() method with an invalid key.
ElementTest::testIsEmpty public function @covers ::isEmpty
ElementTest::testProperties public function Tests the properties() method.
ElementTest::testProperty public function Tests the property() method.
ElementTest::testSetAttributes public function Tests the setAttributes() method.
ElementTest::testVisibleChildren public function Tests the visibleChildren() method.
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
UnitTestCase::$randomGenerator protected property The random generator.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::assertArrayEquals Deprecated protected function Asserts if two arrays are equal by sorting them first.
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator protected function Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName public function Generates a unique random string containing letters and numbers.
UnitTestCase::setUp protected function 338
UnitTestCase::setUpBeforeClass public static function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.