kalanis\kw_templates\HtmlElement\TAttributes

Complexity

Total Complexity

23

Size/Duplication

Total Lines	138
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	2
Bugs	0	Features	0

10 Methods

Rating	Name	Duplication	Size	Complexity
A	renderAttributes()	0	10	3
A	attributesParse()	0	4	2
B	attributesParseArray()	0	19	7
A	addAttributes()	0	3	1
A	removeAttribute()	0	4	2
A	getAttribute()	0	3	2
A	attributesParseString()	0	11	3
A	getAttributes()	0	3	1
A	setAttribute()	0	3	1
A	setAttributes()	0	4	1

<?php

namespace kalanis\kw_templates\HtmlElement;


/**
 * Trait TAttributes
 * @package kalanis\kw_templates\Template
 * Trait for work with attributes
 * It's not necessary to have attributes directly in HtmlElement
 * @author Adam Dornak original
 * @author Petr Plsek refactored
 */
trait TAttributes
{
    /** @var array<string, string> */
    protected array $attributes = [];

    /**
     * Returns serialized attributes
     * Use $attributes param if is set
     * @param string|array<string, string|int|array<string>>|null $attributes
     * @return string
     */
    protected function renderAttributes($attributes = null): string
    {
        $attributes = is_null($attributes) ? $this->attributes : $this->attributesParse($attributes);

        $return = '';
        foreach ($attributes as $name => $value) {
            $return .= ' ' . $name . '="' . $value . '"';
        }

        return $return;
    }

    /**
     * Add array of attributes into current object attributes
     * @param string|array<string, string|int|array<string>>|null $attributes
     */
    public function addAttributes($attributes): void
    {
        $this->attributes = array_merge($this->attributes, $this->attributesParse($attributes));
    }

    /**
     * Change attributes in variable to 2-dimensional array
     * Expects array, discard rest
     * @param string|array<string, string|int|array<string>>|null $attributes
     * @return array<string, string>
     */
    public function attributesParse($attributes): array
    {
        $attributes = is_array($attributes) ? $attributes : $this->attributesParseString(strval($attributes));
        return $this->attributesParseArray($attributes);
    }

    /**
     * Change attributes in variable to 2-dimensional array
     * Expects array, discard rest
     * @param array<string|int, string|int|array<string>> $attributes
     * @return array<string, string>
     */
    public function attributesParseArray(array $attributes): array
    {
        $array = [];
        foreach ($attributes as $key => $val) {
            if (is_string($key)) {
                $key = strtolower($key);
                if (is_string($val) || is_numeric($val)) {
                    $val = strtolower(strval($val));
                    $array[$key] = $val;
                } else if (is_array($val)) {
                    foreach ($val as &$_val) {
                        $_val = strtolower(strval($_val));
                    }
                    $val = implode(';', $val);
                    $array[$key] = $val;
                }
            }
        }
        return $array;
    }

    /**
     * Change attributes to 2-dimensional array
     * Expects string like: width="100px" height='150px' style="color:red"
     * Discard rest
     * @param string $attributes
     * @return array<string|int, string|int>
     */
    public function attributesParseString(string $attributes): array
    {
        $array = [];
        $string = trim($attributes);
        if (preg_match_all('/([a-z]+)\=("|\')?(.+?)(?(2)\2)(\s|$)/', $string, $matches)) {
            $limit = count($matches[1]);
            for ($i = 0; $i < $limit; $i++) {
                $array[$matches[1][$i]] = trim($matches[3][$i]);
            }
        }
        return $array;
    }

    /**
     * Set attributes, leave nothing from previous ones
     * @param string|array<string, string|int|array<string>>|null $attributes
     */
    public function setAttributes($attributes): void
    {
        $this->attributes = [];
        $this->addAttributes($attributes);
    }

    /**
     * Get all available attributes
     * @return array<string, string>
     */
    public function getAttributes(): array
    {
        return $this->attributes;
    }

    /**
     * Get attribute value
     * @param string $name
     * @return string|null
     */
    public function getAttribute(string $name): ?string
    {
        return isset($this->attributes[$name]) ? $this->attributes[$name] : null ;
    }

    /**
     * Set attribute value
     * @param string $name
     * @param string $value
     */
    public function setAttribute(string $name, string $value): void
    {
        $this->attributes[$name] = $value;
    }

    /**
     * Remove attribute
     * @param string $name
     */
    public function removeAttribute(string $name): void
    {
        if (isset($this->attributes[$name])) {
            unset($this->attributes[$name]);
        }
    }
}