Sirius\Input\Element

Complexity

Total Complexity

22

Size/Duplication

Total Lines	169
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

91.84%

Importance

Changes	4
Bugs	0	Features	0

13 Methods

Rating	Name	Duplication	Size	Complexity
A	inflectUnderscoreToClass()	0	7	1
A	get()	0	9	3
A	set()	0	10	2
A	getDefaultSpecs()	0	4	1
A	getName()	0	4	1
A	setGroup()	0	6	1
A	getGroup()	0	4	2
A	setWidget()	0	6	1
A	getWidget()	0	4	2
A	setPosition()	0	6	1
A	getPosition()	0	4	2
A	__construct()	0	8	2
A	prepareInputFilter()	0	9	3

<?php
namespace Sirius\Input;

use Sirius\Input\Traits\HasAttributesTrait;
use Sirius\Input\Traits\HasDataTrait;
use Sirius\Input\Specs;

/**
 *
 * @method Element getLabel() Get the label text
 * @method Element setLabel($label) Set label text
 * @method Element getLabelAttributes() Get the attributes for the label
 * @method Element setLabelAttributes(array $attributes) Set label attributes
 * @method Element setLabelAttribute($attr, $value = null) Set/Unset label attribute
 * @method Element addLabelClass($class) Add a CSS class to the label
 * @method Element removeLabelClass($class) Removes a CSS class from the label
 * @method Element toggleLabelClass($class) Toggles a class on the label
 * @method Element getHint() Get the hint text
 * @method Element setHint($label) Set hint text
 * @method Element getHintAttributes() Get the attributes for the hint
 * @method Element setHintAttributes(array $attributes) Set hint attributes
 * @method Element setHintAttribute($attr, $value = null) Set/Unset hint attribute
 * @method Element addHintClass($class) Add a CSS class to the hint
 * @method Element removeHintClass($class) Removes a CSS class from the hint
 * @method Element toggleHintClass($class) Toggles a class on the hint
 * @method Element getContainerAttributes() Get the attributes for the container
 * @method Element setContainerAttributes(array $attributes) Set container attributes
 * @method Element setContainerAttribute($attr, $value = null) Set/Unset container attribute
 * @method Element addContainerClass($class) Add a CSS class to the container
 * @method Element removeContainerClass($class) Removes a CSS class from the container
 * @method Element toggleContainerClass($class) Toggles a class on the container
 * @method Element getValidationRules() Get list of validation rules
 * @method Element setValidationRules(array $rules) Set list of validation rules
 * @method Element getFilters() Get list of data filters
 * @method Element setFilters(array $filters) Set list of filters
 * @method Element getUploadContainer() Get the upload container for the element
 * @method Element setUploadContainer($container) Set the upload container for the element
 * @method Element getUploadOptions() Get the upload options for the container
 * @method Element setUploadOptions(array $options) Set the upload options for the container
 * @method Element getUploadRules() Get the upload validation rules
 * @method Element setUploadRules(array $rules) Set the upload validation rules
 */
abstract class Element extends \ArrayObject
{
    use HasAttributesTrait;
    use HasDataTrait;

    /**
     * Name of the field (identifier of the element in the form's child list)
     *
     * @var string
     */
    protected $name;

    /**
     *
     * @param string $name
     *            Name of the form element that will make it identifiable
     * @param array $specs
     *            Specification for the element (attributes, parents, etc)
     */
    public function __construct($name, $specs = array())
    {
        $specs = array_merge($this->getDefaultSpecs(), $specs);
        foreach ($specs as $key => $value) {
            $this->set($key, $value);
        }
        $this->name = $name;
    }

    protected function inflectUnderscoreToClass($var)
    {
        $var = str_replace('_', ' ', $var);
        $var = ucwords($var);

        return str_replace(' ', '', $var);
    }

    public function get($key)
    {
        $method = 'get' . $this->inflectUnderscoreToClass($key);
        if (method_exists($this, $method)) {
            return $this->{$method}();
        }

        return isset($this[$key]) ? $this[$key] : null;
    }

    public function set($key, $value)
    {
        $method = 'set' . $this->inflectUnderscoreToClass($key);
        if (method_exists($this, $method)) {
            return $this->{$method}($value);
        }
        $this[$key] = $value;

        return $this;
    }


    /**
     * Returns the default element specifications
     * The default specs are merged with the constructor specs
     *
     * @return array
     */
    protected function getDefaultSpecs()
    {
        return array();
    }

    /**
     * Retrieve the name of the form's element as registered within the form
     *
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * Sets the group this element belongs to
     *
     * @param null|string $group
     *
     * @return $this
     */
    public function setGroup($group = null)
    {
        $this[Specs::GROUP] = (string) $group;

        return $this;
    }

    /**
     * Retrieve the group this element belongs to
     *
     * @return null|string
     */
    public function getGroup()
    {
        return isset($this[Specs::GROUP]) ? $this[Specs::GROUP] : null;
    }

    /**
     * Sets the widget for this element
     *
     * @param null|string $widget
     *
     * @return $this
     */
    public function setWidget($widget = null)
    {
        $this[Specs::WIDGET] = (string) $widget;

        return $this;
    }

    /**
     * Retrieve the widget type for this element
     *
     * @return string
     */
    public function getWidget()
    {
        return isset($this[Specs::WIDGET]) ? $this[Specs::WIDGET] : null;
    }

    /**
     * Sets the display priority for this element
     *
     * @param integer $priority
     *
     * @return $this
     */
    public function setPosition($priority = 0)
    {
        $this[Specs::POSITION] = (int) $priority;

        return $this;
    }

    /**
     * Retrieve display position for this element
     *
     * @return integer
     */
    public function getPosition()
    {
        return isset($this[Specs::POSITION]) ? $this[Specs::POSITION] : 0;
    }


    /**
     * Prepares the input filter to receive data and be rendered
     * It attaches the filters, validation rules, upload handler for the element
     *
     * @param InputFilter $inputFilter
     */
    public function prepareInputFilter(InputFilter $inputFilter)
    {
        $preparableMethods = array('prepareValidator', 'prepareFiltrator', 'prepareUploadHandlers');
        foreach ($preparableMethods as $method) {
            if (method_exists($this, $method)) {
                call_user_func(array($this, $method), $inputFilter);
            }
        }
    }

}