class IconDefinitionTest

@coversDefaultClass \Drupal\Core\Theme\Icon\IconDefinition

@group icon

Hierarchy

Expanded class hierarchy of IconDefinitionTest

File

core/tests/Drupal/Tests/Core/Theme/Icon/IconDefinitionTest.php, line 18

Namespace

Drupal\Tests\Core\Theme\Icon
View source
class IconDefinitionTest extends UnitTestCase {
    
    /**
     * Data provider for ::testCreateIcon().
     *
     * @return \Generator
     *   The test cases.
     */
    public static function providerCreateIcon() : iterable {
        (yield 'minimal icon' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
            ],
        ]);
        (yield 'icon with source' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'source' => 'foo/bar',
            ],
        ]);
        (yield 'icon with empty source' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'source' => '',
            ],
        ]);
        (yield 'icon with empty data' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'source' => '',
                'group' => '',
                'data' => [
                    'content' => '',
                    'library' => '',
                ],
            ],
        ]);
        (yield 'icon with null data' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'source' => NULL,
                'group' => NULL,
                'data' => [
                    'content' => NULL,
                    'library' => NULL,
                ],
            ],
        ]);
        (yield 'icon with data' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'source' => 'foo/bar',
                'group' => 'quux',
                'data' => [
                    'content' => 'corge',
                    'label' => new TranslatableMarkup('Qux'),
                    'library' => 'foo/bar',
                    'foo' => 'bar',
                ],
            ],
        ]);
    }
    
    /**
     * Test the IconDefinition::createIcon method.
     *
     * @param array $data
     *   The icon data.
     *
     * @dataProvider providerCreateIcon
     */
    public function testCreateIcon(array $data) : void {
        $icon_data = $data['data'] ?? NULL;
        if ($icon_data) {
            $actual = IconDefinition::create($data['pack_id'], $data['icon_id'], $data['template'], $data['source'] ?? NULL, $data['group'] ?? NULL, $icon_data);
        }
        else {
            $actual = IconDefinition::create($data['pack_id'], $data['icon_id'], $data['template'], $data['source'] ?? NULL, $data['group'] ?? NULL);
        }
        $icon_full_id = IconDefinition::createIconId($data['pack_id'], $data['icon_id']);
        $this->assertEquals($icon_full_id, $actual->getId());
        $this->assertEquals(IconDefinition::humanize($data['icon_id']), $actual->getLabel());
        $this->assertEquals($data['icon_id'], $actual->getIconId());
        $this->assertEquals($data['pack_id'], $actual->getPackId());
        $this->assertEquals($data['template'], $actual->getTemplate());
        if (isset($data['source'])) {
            $this->assertEquals($data['source'], $actual->getSource());
        }
        if (isset($data['group'])) {
            $this->assertEquals($data['group'], $actual->getGroup());
        }
        if ($icon_data) {
            if (isset($icon_data['library'])) {
                $this->assertEquals($icon_data['library'], $actual->getLibrary());
                unset($icon_data['library']);
            }
            if (isset($icon_data['label'])) {
                $this->assertSame($icon_data['label'], $actual->getPackLabel());
                unset($icon_data['label']);
            }
            foreach ($icon_data as $key => $value) {
                $this->assertEquals($icon_data[$key], $actual->getData($key));
            }
        }
    }
    
    /**
     * Test the IconDefinition::create method with errors.
     */
    public function testCreateIconError() : void {
        $this->expectException(IconDefinitionInvalidDataException::class);
        $this->expectExceptionMessage('Empty pack_id provided! Empty icon_id provided! Empty template provided!');
        IconDefinition::create('', '', '');
    }
    
    /**
     * Data provider for ::testCreateIcon().
     *
     * @return array
     *   The test cases with icon_id and expected label.
     */
    public static function providerCreateIconHumanize() : array {
        return [
            'simple' => [
                'foo',
                'Foo',
            ],
            'with space' => [
                '  foo  ',
                'Foo',
            ],
            'with parts' => [
                'foo_bar',
                'Foo Bar',
            ],
            'with capital letters' => [
                'foo BAR bάz',
                'Foo Bar Bάz',
            ],
            'long with special characters' => [
                'foo --  Bar (1) -24',
                'Foo Bar124',
            ],
            'special characters' => [
                'j([{Fh- x1|_e$0__--Zr|7]ç$U_nE -B',
                'J Fh X1 E0 Zr7 Ç Un Eb',
            ],
        ];
    }
    
    /**
     * Test the IconDefinition::humanize method.
     *
     * @param string $icon_id
     *   The icon id.
     * @param string $expected
     *   The expected label.
     *
     * @dataProvider providerCreateIconHumanize
     */
    public function testCreateIconHumanize(string $icon_id, string $expected) : void {
        $icon = IconDefinition::create('bar', $icon_id, 'baz');
        $this->assertEquals($expected, $icon->getLabel());
    }
    
    /**
     * Test the IconDefinition::getRenderable method.
     */
    public function testGetRenderable() : void {
        $icon = IconDefinition::create('foo', 'bar', '_template_');
        $expected = [
            '#type' => 'icon',
            '#pack_id' => 'foo',
            '#icon_id' => 'bar',
            '#settings' => [
                'baz' => 'corge',
            ],
        ];
        $actual = IconDefinition::getRenderable('foo:bar', [
            'baz' => 'corge',
        ]);
        $this->assertEquals($expected, $actual);
    }
    
    /**
     * Data provider for ::testGetPreview().
     *
     * @return \Generator
     *   Provide test data as icon data and expected result.
     */
    public static function providerGetPreview() : iterable {
        (yield 'minimal icon' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
            ],
            [],
            [
                '#icon_label' => 'Bar',
                '#icon_id' => 'bar',
                '#pack_id' => 'foo',
                '#extractor' => NULL,
                '#source' => NULL,
                '#library' => NULL,
                '#settings' => [],
            ],
        ]);
        (yield 'minimal icon with settings' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
            ],
            [
                'baz' => 'corge',
                0 => 1,
                'grault',
            ],
            [
                '#icon_label' => 'Bar',
                '#icon_id' => 'bar',
                '#pack_id' => 'foo',
                '#extractor' => NULL,
                '#source' => NULL,
                '#library' => NULL,
                '#settings' => [
                    'baz' => 'corge',
                    0 => 1,
                    1 => 'grault',
                ],
            ],
        ]);
        (yield 'icon with data and settings' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'data' => [
                    'extractor' => 'qux',
                ],
            ],
            [
                'baz' => 'corge',
            ],
            [
                '#icon_label' => 'Bar',
                '#icon_id' => 'bar',
                '#pack_id' => 'foo',
                '#extractor' => 'qux',
                '#source' => NULL,
                '#library' => NULL,
                '#settings' => [
                    'baz' => 'corge',
                ],
            ],
        ]);
        (yield 'icon with data' => [
            [
                'pack_id' => 'foo',
                'icon_id' => 'bar',
                'template' => 'baz',
                'source' => 'quux',
                'data' => [
                    'extractor' => 'qux',
                    'library' => 'corge',
                ],
            ],
            [
                'baz' => 'corge',
            ],
            [
                '#icon_label' => 'Bar',
                '#icon_id' => 'bar',
                '#pack_id' => 'foo',
                '#extractor' => 'qux',
                '#source' => 'quux',
                '#library' => 'corge',
                '#settings' => [
                    'baz' => 'corge',
                ],
            ],
        ]);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overrides
ExpectDeprecationTrait::expectDeprecation public function Adds an expected deprecation.
ExpectDeprecationTrait::getCallableName private static function Returns a callable as a string suitable for inclusion in a message.
ExpectDeprecationTrait::setUpErrorHandler public function Sets up the test error handler.
ExpectDeprecationTrait::tearDownErrorHandler public function Tears down the test error handler.
IconDefinitionTest::providerCreateIcon public static function Data provider for ::testCreateIcon().
IconDefinitionTest::providerCreateIconHumanize public static function Data provider for ::testCreateIcon().
IconDefinitionTest::providerGetPreview public static function Data provider for ::testGetPreview().
IconDefinitionTest::testCreateIcon public function Test the IconDefinition::createIcon method.
IconDefinitionTest::testCreateIconError public function Test the IconDefinition::create method with errors.
IconDefinitionTest::testCreateIconHumanize public function Test the IconDefinition::humanize method.
IconDefinitionTest::testGetRenderable public function Test the IconDefinition::getRenderable method.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
UnitTestCase::$root protected property The app root.
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::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUp protected function 367
UnitTestCase::setUpBeforeClass public static function

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