Aura\Html\Helper\Title

Complexity

Total Complexity

10

Size/Duplication

Total Lines	145
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

76.19%

Importance

Changes	8
Bugs	0	Features	2

9 Methods

Rating	Name	Duplication	Size	Complexity
A	setRaw()	0	5	1
A	__invoke()	0	7	2
A	__toString()	0	6	1
A	set()	0	5	1
A	get()	0	4	1
A	append()	0	5	1
A	appendRaw()	0	5	1
A	prepend()	0	5	1
A	prependRaw()	0	5	1

<?php
/**
 *
 * This file is part of Aura for PHP.
 *
 * @license http://opensource.org/licenses/bsd-license.php BSD
 *
 */
namespace Aura\Html\Helper;

/**
 *
 * Helper to generate a `<title>` tag.
 *
 * @package Aura.Html
 *
 */
class Title extends AbstractHelper
{
    /**
     *
     * The title value.
     *
     * @var string
     *
     */
    protected $title = null;

    /**
     *
     * Returns the helper so you can call methods on it; alternatively, if you
     * pass a title string, it will be as you called `append()`.
     *
     * @param string $text Text to append to the existing title.
     *
     * @return self
     *
     */
    public function __invoke($text = null)
    {
        if ($text) {

The expression $text of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

            $this->append($text);
        }
        return $this;
    }

    /**
     *
     * Returns the current title string.
     *
     * @return string The current title string.
     *
     */
    public function __toString()
    {
        $title = $this->indent(1, "<title>{$this->title}</title>");
        $this->title = null;
        return $title;
    }

    /**
     *
     * Escapes and sets text as the <title> string.
     *
     * @param string $text The title string.
     *
     * @return self
     *
     */
    public function set($text)
    {
        $this->title = $this->escaper->html($text);
        return $this;
    }

    /**
     *
     * Sets raw text as the <title> string.
     *
     * @param string $text The title string.
     *
     * @return self
     *
     */
    public function setRaw($text)
    {
        $this->title = $text;
        return $this;
    }

    /**
     *
     * Gets the currently set title string without HTML tag
     *
     * @return string
     *
     */
    public function get()
    {
        return $this->title;
    }

    /**
     *
     * Escapes and appends text to the end of the current <title> string.
     *
     * @param string $text The string to be appended to the title.
     *
     * @return self
     *
     */
    public function append($text)
    {
        $this->title .= $this->escaper->html($text);
        return $this;
    }

    /**
     *
     * Appends raw text to the end of the current <title> string.
     *
     * @param string $text The string to be appended to the title.
     *
     * @return self
     *
     */
    public function appendRaw($text)
    {
        $this->title .= $text;
        return $this;
    }

    /**
     *
     * Escapes and prepends text to the beginning of the current <title> string.
     *
     * @param string $text The string to be appended to the title.
     *
     * @return self
     *
     */
    public function prepend($text)
    {
        $this->title = $this->escaper->html($text) . $this->title;
        return $this;
    }

    /**
     *
     * Prepends raw text to the beginning of the current <title> string.
     *
     * @param string $text The string to be appended to the title.
     *
     * @return self
     *
     */
    public function prependRaw($text)
    {
        $this->title = $text . $this->title;
        return $this;
    }
}