Sirius\Html\Builder

Complexity

Total Complexity

18

Size/Duplication

Total Lines	162
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	1

Test Coverage

Coverage

95.45%

Importance

Changes	12
Bugs	4	Features	2

7 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	4	1
A	setOption()	0	4	1
A	getOption()	0	4	2
A	with()	0	9	2
A	registerTag()	0	6	1
C	make()	0	26	7
A	__call()	0	16	4

<?php
namespace Sirius\Html;

class Builder
{

    /**
     * A list of configuration parameters that can be used
     * by tags, decorators etc when rendering
     *
     * @var array
     */
    protected $options = array();

    /**
     * tag-to-class name mappings
     *
     * @var array
     */
    protected $tagFactories = array(
        'button'      => 'Sirius\Html\Tag\Button',
        'checkbox'    => 'Sirius\Html\Tag\Checkbox',
        'file'        => 'Sirius\Html\Tag\File',
        'hidden'      => 'Sirius\Html\Tag\Hidden',
        'img'         => 'Sirius\Html\Tag\Img',
        'multiselect' => 'Sirius\Html\Tag\MultiSelect',
        'password'    => 'Sirius\Html\Tag\Password',
        'radio'       => 'Sirius\Html\Tag\Radio',
        'select'      => 'Sirius\Html\Tag\Select',
        'text'        => 'Sirius\Html\Tag\Text',
        'textarea'    => 'Sirius\Html\Tag\Textarea'
    );

    /**
     * @param array $options
     */
    public function __construct($options = array())
    {
        $this->options = $options;
    }

    /**
     * Sets a value of an option
     *
     * @param $name
     * @param $value
     */
    public function setOption($name, $value)
    {
        $this->options[$name] = $value;
    }

    /**
     * Get a configuration option
     *
     * @param $name
     *
     * @return null
     */
    public function getOption($name)
    {
        return isset($this->options[$name]) ? $this->options[$name] : null;
    }

    /**
     * Clones the instance and applies new set of options
     *
     * @param $options
     *
     * @return Builder
     */
    public function with($options)
    {
        $clone = clone $this;
        foreach ($options as $name => $value) {
            $clone->setOption($name, $value);
        }

        return $clone;
    }

    /**
     * Add an element factory (class or callback)
     *
     * @param string $name
     * @param mixed $classOrCallback
     *
     * @return self
     */
    public function registerTag($name, $classOrCallback)
    {
        $this->tagFactories[$name] = $classOrCallback;

        return $this;
    }

    /**
     * Make an HTML tag with a specific tag name (div, p, section etc)
     *
     * @param string $tag
     * @param mixed $props
     * @param mixed $content
     *
     * @throws \InvalidArgumentException
     * @return Tag
     */
    public function make($tag, $props = null, $content = null)
    {
        if (! isset($this->tagFactories[$tag])) {
            return Tag::create($tag, $props, $content, $this);
        }

        $constructor = $this->tagFactories[$tag];

        if (is_callable($constructor)) {
            /* @var $tag Tag */
            $tag = call_user_func($constructor, $props, $content, $this);
        } elseif (is_string($constructor) && class_exists($constructor)) {
            /* @var $tag Tag */
            $tag = new $constructor($props, $content, $this);
        }

        if (! $tag || ! $tag instanceof Tag) {
            throw  new \InvalidArgumentException(sprintf(
                'The constructor for the `%s` tag did not generate a Tag object',
                $tag
            ));
        }

        return $tag;

    }

    /**
     * Magic method for creating HTML tags
     *
     * @example
     * $builder->h1(null, 'Heading 1'); // <h1>Heading 1</h1>
     * $builder->article(['class' => 'post-body'], 'Article body');
     * // outputs: '<article class='post-body'>Article body</article>
     *
     * $builder->someTag(); // <some-tag></some-tag>
     *
     * @param string $method
     * @param array $args
     *
     * @return Tag
     */
    public function __call($method, $args)
    {
        $method = preg_replace('/([A-Z]+)/', '-\1', $method);
        $method = strtolower($method);
        if (! isset($args[0])) {
            $args[0] = array();
        }
        if (! isset($args[1])) {
            $args[1] = null;
        }
        if (! isset($args[2])) {
            $args[2] = null;
        }

        return $this->make($method, $args[0], $args[1]);
    }
}