TagBuilderTest.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Fluid\Tests\Unit\Core\ViewHelper;

/*                                                                        *
 * This script is backported from the TYPO3 Flow package "TYPO3.Fluid".   *
 *                                                                        *
 * It is free software; you can redistribute it and/or modify it under    *
 * the terms of the GNU Lesser General Public License, either version 3   *
 *  of the License, or (at your option) any later version.                *
 *                                                                        *
 * The TYPO3 project - inspiring people to share!                         *
 *                                                                        */

class TagBuilderTest extends \TYPO3\CMS\Core\Tests\UnitTestCase
{
    public function constructorSetsTagName()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('someTagName');
        $this->assertEquals('someTagName', $tagBuilder->getTagName());
    }

    public function constructorSetsTagContent()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('', '<some text>');
        $this->assertEquals('<some text>', $tagBuilder->getContent());
    }

    public function setContentDoesNotEscapeValue()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder();
        $tagBuilder->setContent('<to be escaped>', false);
        $this->assertEquals('<to be escaped>', $tagBuilder->getContent());
    }

    public function hasContentReturnsTrueIfTagContainsText()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('', 'foo');
        $this->assertTrue($tagBuilder->hasContent());
    }

    public function hasContentReturnsFalseIfContentIsNull()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder();
        $tagBuilder->setContent(null);
        $this->assertFalse($tagBuilder->hasContent());
    }

    public function hasContentReturnsFalseIfContentIsAnEmptyString()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder();
        $tagBuilder->setContent('');
        $this->assertFalse($tagBuilder->hasContent());
    }

    public function renderReturnsEmptyStringByDefault()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder();
        $this->assertEquals('', $tagBuilder->render());
    }

    public function renderReturnsSelfClosingTagIfNoContentIsSpecified()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $this->assertEquals('<tag />', $tagBuilder->render());
    }

    public function contentCanBeRemoved()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag', 'some content');
        $tagBuilder->setContent(null);
        $this->assertEquals('<tag />', $tagBuilder->render());
    }

    public function renderReturnsOpeningAndClosingTagIfNoContentIsSpecifiedButForceClosingTagIsTrue()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $tagBuilder->forceClosingTag(true);
        $this->assertEquals('<tag></tag>', $tagBuilder->render());
    }

    public function attributesAreProperlyRendered()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $tagBuilder->addAttribute('attribute1', 'attribute1value');
        $tagBuilder->addAttribute('attribute2', 'attribute2value');
        $tagBuilder->addAttribute('attribute3', 'attribute3value');
        $this->assertEquals('<tag attribute1="attribute1value" attribute2="attribute2value" attribute3="attribute3value" />', $tagBuilder->render());
    }

    public function attributeValuesAreEscapedByDefault()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $tagBuilder->addAttribute('foo', '<to be escaped>');
        $this->assertEquals('<tag foo="&lt;to be escaped&gt;" />', $tagBuilder->render());
    }

    public function attributeValuesAreNotEscapedIfDisabled()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $tagBuilder->addAttribute('foo', '<not to be escaped>', false);
        $this->assertEquals('<tag foo="<not to be escaped>" />', $tagBuilder->render());
    }

    public function attributesCanBeRemoved()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $tagBuilder->addAttribute('attribute1', 'attribute1value');
        $tagBuilder->addAttribute('attribute2', 'attribute2value');
        $tagBuilder->addAttribute('attribute3', 'attribute3value');
        $tagBuilder->removeAttribute('attribute2');
        $this->assertEquals('<tag attribute1="attribute1value" attribute3="attribute3value" />', $tagBuilder->render());
    }

    public function attributesCanBeAccessed()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $tagBuilder->addAttribute('attribute1', 'attribute1value');
        $attributeValue = $tagBuilder->getAttribute('attribute1');
        $this->assertSame('attribute1value', $attributeValue);
    }

    public function getAttributeWithMissingAttributeReturnsNull()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('tag');
        $attributeValue = $tagBuilder->getAttribute('missingattribute');
        $this->assertNull($attributeValue);
    }

    public function resetResetsTagBuilder()
    {
        $tagBuilder = $this->getAccessibleMock(\TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder::class, ['dummy']);
        $tagBuilder->setTagName('tagName');
        $tagBuilder->setContent('some content');
        $tagBuilder->forceClosingTag(true);
        $tagBuilder->addAttribute('attribute1', 'attribute1value');
        $tagBuilder->addAttribute('attribute2', 'attribute2value');
        $tagBuilder->reset();

        $this->assertEquals('', $tagBuilder->_get('tagName'));
        $this->assertEquals('', $tagBuilder->_get('content'));
        $this->assertEquals([], $tagBuilder->_get('attributes'));
        $this->assertFalse($tagBuilder->_get('forceClosingTag'));
    }

    public function tagNameCanBeOverridden()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('foo');
        $tagBuilder->setTagName('bar');
        $this->assertEquals('<bar />', $tagBuilder->render());
    }

    public function tagContentCanBeOverridden()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('foo', 'some content');
        $tagBuilder->setContent('');
        $this->assertEquals('<foo />', $tagBuilder->render());
    }

    public function tagIsNotRenderedIfTagNameIsEmpty()
    {
        $tagBuilder = new \TYPO3\CMS\Fluid\Core\ViewHelper\TagBuilder('foo');
        $tagBuilder->setTagName('');
        $this->assertEquals('', $tagBuilder->render());
    }
}