ThemeTest.php

<?php

namespace Drupal\Tests\system\Kernel\Theme;

use Drupal\Component\Render\FormattableMarkup;
use Drupal\KernelTests\KernelTestBase;
use Drupal\Component\Render\MarkupInterface;

/**
 * Tests low-level theme functions.
 *
 * @group Theme
 */
class ThemeTest extends KernelTestBase {
    
    /**
     * {@inheritdoc}
     */
    public static $modules = [
        'theme_test',
        'node',
        'system',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() {
        parent::setUp();
        \Drupal::service('theme_installer')->install([
            'test_theme',
        ]);
    }
    
    /**
     * Test attribute merging.
     *
     * Render arrays that use a render element and templates (and hence call
     * template_preprocess()) must ensure the attributes at different occasions
     * are all merged correctly:
     *   - $variables['attributes'] as passed in to the theme hook implementation.
     *   - the render element's #attributes
     *   - any attributes set in the template's preprocessing function
     */
    public function testAttributeMerging() {
        $theme_test_render_element = [
            'elements' => [
                '#attributes' => [
                    'data-foo' => 'bar',
                ],
            ],
            'attributes' => [
                'id' => 'bazinga',
            ],
        ];
        $this->assertThemeOutput('theme_test_render_element', $theme_test_render_element, '<div id="bazinga" data-foo="bar" data-variables-are-preprocessed></div>' . "\n");
    }
    
    /**
     * Test that ThemeManager renders the expected data types.
     */
    public function testThemeDataTypes() {
        // theme_test_false is an implemented theme hook so \Drupal::theme() service
        // should return a string or an object that implements MarkupInterface,
        // even though the theme function itself can return anything.
        $foos = [
            'null' => NULL,
            'false' => FALSE,
            'integer' => 1,
            'string' => 'foo',
            'empty_string' => '',
        ];
        foreach ($foos as $type => $example) {
            $output = \Drupal::theme()->render('theme_test_foo', [
                'foo' => $example,
            ]);
            $this->assertTrue($output instanceof MarkupInterface || is_string($output), new FormattableMarkup('\\Drupal::theme() returns an object that implements MarkupInterface or a string for data type @type.', [
                '@type' => $type,
            ]));
            if ($output instanceof MarkupInterface) {
                $this->assertIdentical((string) $example, $output->__toString());
            }
            elseif (is_string($output)) {
                $this->assertIdentical($output, '', 'A string will be return when the theme returns an empty string.');
            }
        }
        // suggestionnotimplemented is not an implemented theme hook so \Drupal::theme() service
        // should return FALSE instead of a string.
        $output = \Drupal::theme()->render([
            'suggestionnotimplemented',
        ], []);
        $this->assertIdentical($output, FALSE, '\\Drupal::theme() returns FALSE when a hook suggestion is not implemented.');
    }
    
    /**
     * Test function theme_get_suggestions() for SA-CORE-2009-003.
     */
    public function testThemeSuggestions() {
        // Set the front page as something random otherwise the CLI
        // test runner fails.
        $this->config('system.site')
            ->set('page.front', '/nobody-home')
            ->save();
        $args = [
            'node',
            '1',
            'edit',
        ];
        $suggestions = theme_get_suggestions($args, 'page');
        $this->assertEqual($suggestions, [
            'page__node',
            'page__node__%',
            'page__node__1',
            'page__node__edit',
        ], 'Found expected node edit page suggestions');
        // Check attack vectors.
        $args = [
            'node',
            '\\1',
        ];
        $suggestions = theme_get_suggestions($args, 'page');
        $this->assertEqual($suggestions, [
            'page__node',
            'page__node__%',
            'page__node__1',
        ], 'Removed invalid \\ from suggestions');
        $args = [
            'node',
            '1/',
        ];
        $suggestions = theme_get_suggestions($args, 'page');
        $this->assertEqual($suggestions, [
            'page__node',
            'page__node__%',
            'page__node__1',
        ], 'Removed invalid / from suggestions');
        $args = [
            'node',
            "1\x00",
        ];
        $suggestions = theme_get_suggestions($args, 'page');
        $this->assertEqual($suggestions, [
            'page__node',
            'page__node__%',
            'page__node__1',
        ], 'Removed invalid \\0 from suggestions');
        // Define path with hyphens to be used to generate suggestions.
        $args = [
            'node',
            '1',
            'hyphen-path',
        ];
        $result = [
            'page__node',
            'page__node__%',
            'page__node__1',
            'page__node__hyphen_path',
        ];
        $suggestions = theme_get_suggestions($args, 'page');
        $this->assertEqual($suggestions, $result, 'Found expected page suggestions for paths containing hyphens.');
    }
    
    /**
     * Test the listInfo() function.
     */
    public function testListThemes() {
        $this->container
            ->get('theme_installer')
            ->install([
            'test_subtheme',
        ]);
        $theme_handler = $this->container
            ->get('theme_handler');
        $themes = $theme_handler->listInfo();
        // Check if ThemeHandlerInterface::listInfo() retrieves enabled themes.
        $this->assertIdentical(1, $themes['test_theme']->status, 'Installed theme detected');
        // Check if ThemeHandlerInterface::listInfo() returns disabled themes.
        // Check for base theme and subtheme lists.
        $base_theme_list = [
            'test_basetheme' => 'Theme test base theme',
        ];
        $sub_theme_list = [
            'test_subsubtheme' => 'Theme test subsubtheme',
            'test_subtheme' => 'Theme test subtheme',
        ];
        $this->assertIdentical($themes['test_basetheme']->sub_themes, $sub_theme_list, 'Base theme\'s object includes list of subthemes.');
        $this->assertIdentical($themes['test_subtheme']->base_themes, $base_theme_list, 'Subtheme\'s object includes list of base themes.');
        // Check for theme engine in subtheme.
        $this->assertIdentical($themes['test_subtheme']->engine, 'twig', 'Subtheme\'s object includes the theme engine.');
        // Check for theme engine prefix.
        $this->assertIdentical($themes['test_basetheme']->prefix, 'twig', 'Base theme\'s object includes the theme engine prefix.');
        $this->assertIdentical($themes['test_subtheme']->prefix, 'twig', 'Subtheme\'s object includes the theme engine prefix.');
    }
    
    /**
     * Tests child element rendering for 'render element' theme hooks.
     */
    public function testDrupalRenderChildren() {
        $element = [
            '#theme' => 'theme_test_render_element_children',
            'child' => [
                '#markup' => 'Foo',
            ],
        ];
        $this->assertThemeOutput('theme_test_render_element_children', $element, 'Foo', 'drupal_render() avoids #theme recursion loop when rendering a render element.');
        $element = [
            '#theme_wrappers' => [
                'theme_test_render_element_children',
            ],
            'child' => [
                '#markup' => 'Foo',
            ],
        ];
        $this->assertThemeOutput('theme_test_render_element_children', $element, 'Foo', 'drupal_render() avoids #theme_wrappers recursion loop when rendering a render element.');
    }
    
    /**
     * Tests drupal_find_theme_templates().
     */
    public function testFindThemeTemplates() {
        $registry = $this->container
            ->get('theme.registry')
            ->get();
        $templates = drupal_find_theme_templates($registry, '.html.twig', drupal_get_path('theme', 'test_theme'));
        $this->assertEqual($templates['node__1']['template'], 'node--1', 'Template node--1.html.twig was found in test_theme.');
    }

}