Charcoal\Ui\UiItemTrait

Complexity

Total Complexity

51

Size/Duplication

Total Lines	588
Duplicated Lines	2.04 %

Coupling/Cohesion

Components	3
Dependencies	2

Importance

Changes

0

36 Methods

Rating	Name	Duplication	Size	Complexity
A	setActive()	0	6	1
A	active()	0	4	1
A	setType()	12	12	3
A	type()	0	7	2
A	setTemplate()	0	12	2
A	template()	0	8	2
A	setTitle()	0	5	1
A	title()	0	4	1
A	setTabTitle()	0	5	1
A	tabTitle()	0	4	2
A	setSubtitle()	0	5	1
A	subtitle()	0	4	1
A	setDescription()	0	5	1
A	description()	0	4	1
A	setNotes()	0	5	1
A	notes()	0	4	1
A	icon()	0	4	1
A	setIcon()	0	6	1
A	setShowTitle()	0	6	1
A	showTitle()	0	8	2
A	setShowSubtitle()	0	6	1
A	showSubtitle()	0	8	2
A	setShowDescription()	0	6	1
A	showDescription()	0	8	2
A	setShowNotes()	0	6	1
A	showNotes()	0	8	2
A	setShowIcon()	0	6	1
A	showIcon()	0	8	2
A	setShowHeader()	0	6	1
A	showHeader()	0	8	2
A	setShowFooter()	0	6	1
A	showFooter()	0	8	2
A	setShowTabTitle()	0	6	1
A	showTabTitle()	0	8	2
A	sortItemsByPriority()	0	12	3
	translator()	0	1	?

<?php

namespace Charcoal\Ui;

use InvalidArgumentException;

// From 'charcoal-ui'
use Charcoal\Ui\PrioritizableInterface;

/**
 * Provides an implementation of {@see \Charcoal\Ui\UiItemInterface}.
 */
trait UiItemTrait
{
    /**
     * @var boolean
     */
    private $active = true;

    /**
     * The UI item type.
     *
     * @var string|null
     */
    private $type;

    /**
     * The UI item's template.
     *
     * @var string|null
     */
    private $template;

    /**
     * The UI item's icon.
     *
     * Note: Only icons from the {@link http://fontawesome.io/ Font Awesome}
     * library are supported.
     *
     * @var string|null
     */
    private $icon;

    /**
     * The UI item's title.
     *
     * @var \Charcoal\Translator\Translation
     */
    private $title = '';

    /**
     * The UI item's tab title.
     *
     * @var \Charcoal\Translator\Translation
     */
    private $tabTitle = '';

    /**
     * The UI item's sub-title.
     *
     * @var \Charcoal\Translator\Translation
     */
    private $subtitle = '';

    /**
     * The UI item's description.
     *
     * @var \Charcoal\Translator\Translation
     */
    private $description = '';

    /**
     * The UI item's notes.
     *
     * @var \Charcoal\Translator\Translation
     */
    private $notes = '';

    /**
     * The title is displayed by default.
     *
     * @var boolean
     */
    private $showTitle = true;

    /**
     * The sub-title is displayed by default.
     *
     * @var boolean
     */
    private $showSubtitle = true;

    /**
     * The description is displayed by default.
     *
     * @var boolean
     */
    private $showDescription = true;

    /**
     * The notes are displayed by default.
     *
     * @var boolean
     */
    private $showNotes = true;

    /**
     * The icon is displayed by default.
     *
     * @var boolean
     */
    private $showIcon = true;

    /**
     * The header is displayed by default.
     *
     * @var boolean
     */
    private $showHeader = true;

    /**
     * The footer is displayed by default.
     *
     * @var boolean
     */
    private $showFooter = true;

    /**
     * The tab title is dislpayed by default.
     *
     * @var boolean
     */
    private $showTabTitle = true;

    /**
     * Activates/deactivates the UI item.
     *
     * @param  boolean $active Activate (TRUE) or deactivate (FALSE) the UI item.
     * @return self
     */
    public function setActive($active)
    {
        $this->active = !!$active;

        return $this;
    }

    /**
     * Determine if the UI item is active.
     *
     * @return boolean
     */
    public function active()
    {
        return $this->active;
    }

    /**
     * Set the UI item type.
     *
     * @param  string|null $type The UI item type.
     * @throws InvalidArgumentException If the type is not a string (or null).
     * @return self
     */
    public function setType($type)

This method seems to be duplicated in your project.

    {
        if (is_string($type) || $type === null) {
            $this->type = $type;
        } else {
            throw new InvalidArgumentException(
                'Can not set UI item config type: Type must be a string or NULL'
            );
        }

        return $this;
    }

    /**
     * Retrieve the UI item type.
     *
     * If it is not explicitely set (or null), then return the object's FQN.
     *
     * @return string
     */
    public function type()
    {
        if ($this->type === null) {
            return static::class;
        }
        return $this->type;
    }

    /**
     * Set the UI item's template.
     *
     * Usually, a path to a file containing the template to be rendered.
     *
     * @param  string $template A template (identifier).
     * @throws InvalidArgumentException If the template is not a string.
     * @return self
     */
    public function setTemplate($template)
    {
        if (!is_string($template)) {
            throw new InvalidArgumentException(
                'The UI Item can not set the template, must be a string'
            );
        }

        $this->template = $template;

        return $this;
    }

    /**
     * Retrieve the UI item's template.
     *
     * @return string If unset, returns the UI item type.
     */
    public function template()
    {
        if ($this->template === null) {
            return $this->type();
        }

        return $this->template;
    }

    /**
     * Set the UI item's title.
     *
     * @param  mixed $title A title.
     * @return self
     */
    public function setTitle($title)
    {
        $this->title = $this->translator()->translation($title);
        return $this;
    }

    /**
     * Retrieve the title.
     *
     * @return \Charcoal\Translator\Translation|null
     */
    public function title()
    {
        return $this->title;
    }

    /**
     * Set the UI item's tab title.
     *
     * @param  mixed $title A title.
     * @return self
     */
    public function setTabTitle($title)
    {
        $this->tabTitle = $this->translator()->translation($title);
        return $this;
    }

    /**
     * Retrieve the tab title.
     *
     * @return \Charcoal\Translator\Translation|null
     */
    public function tabTitle()
    {
        return $this->tabTitle ?: $this->title();
    }

    /**
     * Set the UI item's sub-title.
     *
     * @param  mixed $subtitle A sub-title.
     * @return self
     */
    public function setSubtitle($subtitle)
    {
        $this->subtitle = $this->translator()->translation($subtitle);
        return $this;
    }

    /**
     * Retrieve the sub-title.
     *
     * @return \Charcoal\Translator\Translation|null
     */
    public function subtitle()
    {
        return $this->subtitle;
    }

    /**
     * Set the UI item's description.
     *
     * @param  mixed $description A description.
     * @return self
     */
    public function setDescription($description)
    {
        $this->description = $this->translator()->translation($description);
        return $this;
    }

    /**
     * Retrieve the description.
     *
     * @return \Charcoal\Translator\Translation|null
     */
    public function description()
    {
        return $this->description;
    }

    /**
     * Set notes about the UI item.
     *
     * @param  mixed $notes Notes.
     * @return self
     */
    public function setNotes($notes)
    {
        $this->notes = $this->translator()->translation($notes);
        return $this;
    }

    /**
     * Retrieve the notes.
     *
     * @return \Charcoal\Translator\Translation|null
     */
    public function notes()
    {
        return $this->notes;
    }

    /**
     * Retrieve the path to the item's icon.
     *
     * @return string
     */
    public function icon()
    {
        return $this->icon;
    }

    /**
     * Set the path to the item's icon associated with the object.
     *
     * @param  string $icon A path to an image.
     * @return self
     */
    public function setIcon($icon)
    {
        $this->icon = $icon;

        return $this;
    }

    /**
     * Show/hide the UI item's title.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the title.
     * @return self
     */
    public function setShowTitle($show)
    {
        $this->showTitle = !!$show;

        return $this;
    }

    /**
     * Determine if the title is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is a title.
     */
    public function showTitle()
    {
        if ($this->showTitle === false) {
            return false;
        } else {
            return !!$this->title();
        }
    }

    /**
     * Show/hide the UI item's sub-title.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the sub-title.
     * @return self
     */
    public function setShowSubtitle($show)
    {
        $this->showSubtitle = !!$show;

        return $this;
    }

    /**
     * Determine if the sub-title is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is a sub-title.
     */
    public function showSubtitle()
    {
        if ($this->showSubtitle === false) {
            return false;
        } else {
            return !!$this->subtitle();
        }
    }

    /**
     * Show/hide the UI item's description.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the description.
     * @return self
     */
    public function setShowDescription($show)
    {
        $this->showDescription = !!$show;

        return $this;
    }

    /**
     * Determine if the description is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is a description.
     */
    public function showDescription()
    {
        if ($this->showDescription === false) {
            return false;
        } else {
            return !!$this->description();
        }
    }

    /**
     * Show/hide the UI item's notes.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the notes.
     * @return self
     */
    public function setShowNotes($show)
    {
        $this->showNotes = !!$show;

        return $this;
    }

    /**
     * Determine if the notes is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there are notes.
     */
    public function showNotes()
    {
        if ($this->showNotes === false) {
            return false;
        } else {
            return !!$this->notes();
        }
    }

    /**
     * Show/hide the UI item's icon.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the icon.
     * @return self
     */
    public function setShowIcon($show)
    {
        $this->showIcon = !!$show;

        return $this;
    }

    /**
     * Determine if the icon is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is an icon.
     */
    public function showIcon()
    {
        if ($this->showIcon === false) {
            return false;
        } else {
            return !!$this->icon();
        }
    }

    /**
     * Show/hide the UI item's header.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the header.
     * @return self
     */
    public function setShowHeader($show)
    {
        $this->showHeader = !!$show;

        return $this;
    }

    /**
     * Determine if the header is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there is a title.
     */
    public function showHeader()
    {
        if ($this->showHeader === false) {
            return false;
        } else {
            return $this->showTitle();
        }
    }

    /**
     * Show/hide the UI item's footer.
     *
     * @param  boolean $show Show (TRUE) or hide (FALSE) the footer.
     * @return self
     */
    public function setShowFooter($show)
    {
        $this->showFooter = !!$show;

        return $this;
    }

    /**
     * Determine if the footer is to be displayed.
     *
     * @return boolean If TRUE or unset, check if there are notes.
     */
    public function showFooter()
    {
        if ($this->showFooter === false) {
            return false;
        } else {
            return $this->showNotes();
        }
    }

    /**
     * @param  boolean $showTabTitle Show (TRUE) or hide (FALSE) the tab title.
     * @return self
     */
    public function setShowTabTitle($showTabTitle)
    {
        $this->showTabTitle = !!$showTabTitle;

        return $this;
    }

    /**
     * @return boolean If TRUE or unset, check if there is a title.
     */
    public function showTabTitle()
    {
        if ($this->showTabTitle === false) {
            return false;
        } else {
            return $this->showTitle();
        }
    }

    /**
     * Comparison function used by {@see uasort()}.
     *
     * @param  PrioritizableInterface $a Sortable entity A.
     * @param  PrioritizableInterface $b Sortable entity B.
     * @return integer Sorting value: -1 or 1.
     */
    protected function sortItemsByPriority(
        PrioritizableInterface $a,
        PrioritizableInterface $b
    ) {
        $priorityA = $a->priority();
        $priorityB = $b->priority();

        if ($priorityA === $priorityB) {
            return 0;
        }
        return ($priorityA < $priorityB) ? (-1) : 1;
    }

    /**
     * All UI objects are translatable, therefore are translator-aware.
     *
     * @return \Charcoal\Translator\Translator
     */
    abstract protected function translator();
}