Panel::getId() - Code Metrics - Inspection of "Clean-up, refactoring, update changes html encode." - yiisoft/yii-bulma - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#31)

by Wilmer
created 2021-02-08 19:03 UTC
Panel::getId() A

↳ Parent: Panel::renderItem()
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	2
CRAP Score	1
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	1
eloc	1
c	1
b	0
f	0
nc	1
nop	0
dl	0
loc	3
ccs	2
cts	2
cp	1
crap	1
rs	10
<?php

declare(strict_types=1);

namespace Yiisoft\Yii\Bulma;

use InvalidArgumentException;
use Yiisoft\Arrays\ArrayHelper;
use Yiisoft\Html\Html;

final class Panel extends Widget
{
    public const COLOR_PRIMARY = 'is-primary';
    public const COLOR_LINK = 'is-link';
    public const COLOR_INFO = 'is-info';
    public const COLOR_SUCCESS = 'is-success';
    public const COLOR_WARNING = 'is-warning';
    public const COLOR_DANGER = 'is-danger';
    private const COLOR_ALL = [
        self::COLOR_PRIMARY,
        self::COLOR_LINK,
        self::COLOR_INFO,
        self::COLOR_SUCCESS,
        self::COLOR_WARNING,
        self::COLOR_DANGER,
    ];

    private array $options = [];
    private array $headingOptions = [];
    private ?string $heading = null;
    private string $color = '';
    private array $tabs = [];
    private array $tabsOptions = [];
    private bool $encodeLabels = true;
    private bool $encodeTags = false;
    private string $template = '{panelBegin}{panelHeading}{panelTabs}{panelItems}{panelEnd}';
    private array $tabItems = [];

    protected function run(): string
    {
        $this->buildOptions();

        $tag = ArrayHelper::getValue($this->options, 'tag', 'nav');

        return strtr($this->template, [
            '{panelBegin}' => Html::beginTag($tag, $this->options),
            '{panelBegin}' => Html::beginTag($tag, /** @scrutinizer ignore-type */ $this->options),
            '{panelHeading}' => $this->renderHeading(),
            '{panelTabs}' => $this->renderTabs(),
            '{panelItems}' => implode("\n", $this->tabItems),
            '{panelEnd}' => Html::endTag($tag),
        ]);
    }

    /**
     * String the template for rendering panel.
     *
     * - `{panelBegin}`: _string_, which will render the panel container begin.
     * - `{panelHeading}`: _string_, which will render the panel heading.
     * - `{panelTabs}`: _string_, which will render the panel tabs.
     * - `{panelItems}`: _string_, which will render the panel items.
     * - `{panelEnd}`: _string_, which will render the panel container end.
     *
     * @param string $value
     *
     * @return self
     */
    public function withTemplate(string $value): self
    {
        $new = clone $this;
        $new->template = $value;

        return $new;
    }

    /**
     * @param array $value
     *
     * @return self
     */
    public function withOptions(array $value): self
    {
        $new = clone $this;
        $new->options = $value;

        return $new;
    }

    /**
     * @param string $value
     *
     * @return self
     */
    public function withHeading(string $value): self
    {
        $new = clone $this;
        $new->heading = $value;

        return $new;
    }

    /**
     * @param array $value
     *
     * @return self
     */
    public function withHeadingOptions(array $value): self
    {
        $new = clone $this;
        $new->headingOptions = $value;

        return $new;
    }

    /**
     * Set progress bar color.
     *
     * @var string $value Color class.
     *
     * @return self
     */
    public function withColor(string $value): self
    {
        if (!in_array($value, self::COLOR_ALL, true)) {
            $values = implode('", "', self::COLOR_ALL);
            throw new InvalidArgumentException("Invalid color. Valid values are: \"$values\".");
        }

        $new = clone $this;
        $new->color = $value;

        return $new;
    }

    /**
     * @param array $value
     *
     * @return self
     */
    public function withTabs(array $value): self
    {
        $new = clone $this;
        $new->tabs = $value;

        return $new;
    }

    /**
     * @param array $value
     *
     * @return self
     */
    public function withTabsOptions(array $value): self
    {
        $new = clone $this;
        $new->tabsOptions = $value;

        return $new;
    }

    /**
     * Allows you to enable the encoding tags html.
     *
     * @return self
     */
    public function withEncodeTags(): self
    {
        $new = clone $this;
        $new->encodeTags = true;

        return $new;
    }

    /**
     * @throws \JsonException
     *
     * @return string
     */
    private function renderHeading(): string
    {
        if ($this->heading !== null) {
            Html::addCssClass($this->headingOptions, 'panel-heading');
            return "\n" . Html::tag('p', $this->heading, $this->headingOptions) . "\n";
        }

        return '';
    }

    /**
     * @throws \JsonException
     *
     * @return string
     */
    private function renderTabs(): string
    {
        if (!empty($this->tabs)) {
            $tabs = '';
            foreach ($this->tabs as $index => $item) {
                $tabs .= $this->renderTab($index, $item) . "\n";
            }

            Html::addCssClass($this->tabsOptions, 'panel-tabs');

            return "\n" . Html::tag('p', "\n" . $tabs, $this->tabsOptions) . "\n";
        }

        return '';
    }

    private function buildOptions(): void
    {
        Html::addCssClass($this->options, 'panel');

        $this->options['id'] ??= $this->getId() . '-panel';

        if ($this->encodeTags === false) {
            $this->tabsOptions = array_merge($this->tabsOptions, ['encode' => false]);
        }

        if ($this->color !== '') {
            Html::addCssClass($this->options, $this->color);
        }
    }

    /**
     * @param int $index
     * @param array $item
     *
     * @throws \JsonException
     *
     * @return string
     */
    private function renderTab(int $index, array $item): string
    {
        $id = $this->getId() . '-panel-c' . $index;
        $url = ArrayHelper::getValue($item, 'url', '');
        $label = ArrayHelper::getValue($item, 'label', '');
        $encode = ArrayHelper::getValue($item, 'encode', $this->encodeLabels);
        $linkOptions = ArrayHelper::getValue($item, 'linkOptions', []);
        $tabItems = ArrayHelper::getValue($item, 'items', []);
        $tabItemsContainerOptions = ArrayHelper::getValue($item, 'itemsContainerOptions', []);

        if ($url !== '') {
            $linkOptions['href'] = $url;
        }

        if ($label === '') {
            throw new InvalidArgumentException('The "label" option is required.');
        }

        if ($encode === true) {
            $label = Html::encode($label);
        }

        if ($this->isActive($item)) {
            Html::addCssClass($linkOptions, 'is-active');
        }

        if (is_array($tabItems) && !empty($tabItems)) {
            $linkOptions['href'] ??= '#' . $id;
            $tabItemsContainerOptions['id'] ??= $id;

            $tabItemsContainer = Html::beginTag('div', $tabItemsContainerOptions) . "\n";

            foreach ($tabItems as $tabItem) {
                $tabItemsContainer .= $this->renderItem($tabItem) . "\n";
            }

            $tabItemsContainer .= Html::endTag('div');

            $this->tabItems[$index] = $tabItemsContainer;
        }

        return Html::tag('a', $label, $linkOptions);
    }

    private function renderItem(array $item): string
    {
        $options = ArrayHelper::getValue($item, 'options', []);
        $label = ArrayHelper::getValue($item, 'label', '');
        $icon = ArrayHelper::getValue($item, 'icon', '');
        $encode = ArrayHelper::getValue($item, 'encode', $this->encodeLabels);

        if ($label === '') {
            throw new InvalidArgumentException('The "label" option is required.');
        }

        if ($encode === true) {
            $label = Html::encode($label);
        }

        Html::addCssClass($options, 'panel-block');

        if ($this->isActive($item)) {
            Html::addCssClass($options, 'is-active');
        }

        $labelOptions = ['class' => 'panel-icon'];

        if ($this->encodeTags === false) {
            $labelOptions['encode'] = false;
            $options['encode'] = false;
        }

        if ($icon !== '') {
            $icon = "\n" . Html::tag('i', '', ['class' => $icon, 'aria-hidden' => 'true']) . "\n";
            $label = "\n" . Html::tag('span', $icon, $labelOptions) . "\n" . $label . "\n";
        }

        return Html::tag('a', $label, $options);
    }

    /**
     * Checking if active item.
     *
     * @param array $item
     *
     * @return bool
     */
    private function isActive(array $item): bool
    {
        return (bool) ArrayHelper::getValue($item, 'active', false);
    }
}

yiisoft / yii-bulma

Pull Request — master (#31)

Panel::getId() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
