Nav::items() - Code Metrics - Inspection of "Update docs" - yiisoft/yii-bulma - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#54)

by Wilmer
created 2021-12-24 10:05 UTC
Nav::items() A

↳ Parent: Nav
Complexity

Conditions	1
Paths	1
Size

Total Lines	5
Code Lines	3
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	4
CRAP Score	1
Importance

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

declare(strict_types=1);

namespace Yiisoft\Yii\Bulma;

use InvalidArgumentException;
use Yiisoft\Definitions\Exception\CircularReferenceException;
use Yiisoft\Definitions\Exception\InvalidConfigException;
use Yiisoft\Definitions\Exception\NotInstantiableException;
use Yiisoft\Factory\NotFoundException;
use Yiisoft\Html\Html;
use Yiisoft\Html\Tag\A;
use Yiisoft\Html\Tag\CustomTag;
use Yiisoft\Html\Tag\Div;
use Yiisoft\Html\Tag\Span;
use Yiisoft\Widget\Widget;
.
|-- OtherDir
|   |-- Bar.php
|   `-- Foo.php
`-- SomeDir
    `-- Foo.php

use function implode;
use function is_array;

/**
 * Nav renders a nav HTML component.
 *
 * @link https://bulma.io/documentation/components/navbar/#basic-navbar
 */
final class Nav extends Widget
{
    private bool $activateItems = true;
    private bool $activateParents = false;
    private array $attributes = [];
    private string $currentPath = '';
    private bool $enclosedByStartMenu = false;
    private bool $enclosedByEndMenu = false;
    private array $items = [];
    private string $hasDropdownCssClass = 'has-dropdown';
    private string $isHoverableCssClass = 'is-hoverable';
    private string $navBarDropdownCssClass = 'navbar-dropdown';
    private string $navBarEndCssClass = 'navbar-end';
    private string $navBarItemCssClass = 'navbar-item';
    private string $navBarLinkCssClass = 'navbar-link';
    private string $navBarMenuCssClass = 'navbar-menu';
    private string $navBarStartCssClass = 'navbar-start';

    /**
     * The HTML attributes. The following special options are recognized.
     *
     * @param array $values Attribute values indexed by attribute names.
     *
     * @return self
     *
     * See {@see \Yiisoft\Html\Html::renderTagAttributes()} for details on how attributes are being rendered.
     */
    public function attributes(array $values): self
    {
        $new = clone $this;
        $new->attributes = $values;
        return $new;
    }

    /**
     * Whether to activate parent menu items when one of the corresponding child menu items is active.
     *
     * @return self
     */
    public function activateParents(): self
    {
        $new = clone $this;
        $new->activateParents = true;
        return $new;
    }

    /**
     * Allows you to assign the current path of the url from request controller.
     *
     * @param string $value The current path.
     *
     * @return self
     */
    public function currentPath(string $value): self
    {
        $new = clone $this;
        $new->currentPath = $value;
        return $new;
    }

    /**
     * Align the menu items to the right.
     *
     * @return self
     *
     * @link https://bulma.io/documentation/components/navbar/#navbar-start-and-navbar-end
     */
    public function enclosedByEndMenu(): self
    {
        $new = clone $this;
        $new->enclosedByEndMenu = true;
        return $new;
    }

    /**
     * Align the menu items to left.
     *
     * @return self
     *
     * @link https://bulma.io/documentation/components/navbar/#navbar-start-and-navbar-end
     */
    public function enclosedByStartMenu(): self
    {
        $new = clone $this;
        $new->enclosedByStartMenu = true;
        return $new;
    }

    /**
     * List of items in the nav widget. Each array element represents a single  menu item which can be either a string
     * or an array with the following structure:
     *
     * - label: string, required, the nav item label.
     * - url: optional, the item's URL. Defaults to "#".
     * - visible: bool, optional, whether this menu item is visible. Defaults to true.
     * - linkOptions: array, optional, the HTML attributes of the item's link.
     * - options: array, optional, the HTML attributes of the item container (LI).
     * - active: bool, optional, whether the item should be on active state or not.
     * - dropdownAttributes: array, optional, the HTML options that will be passed to the {@see Dropdown} widget.
     * - items: array|string, optional, the configuration array for creating a {@see Dropdown} widget, or a string
     *   representing the dropdown menu.
     * - encode: bool, optional, whether the label will be HTML-encoded. If set, supersedes the $encodeLabels option for
     *   only this item.
     *
     * If a menu item is a string, it will be rendered directly without HTML encoding.
     *
     * @param array $value The menu items.
     *
     * @return self
     */
    public function items(array $value): self
    {
        $new = clone $this;
        $new->items = $value;
        return $new;
    }

    /**
     * Disable activate items according to whether their currentPath.
     *
     * @return self
     *
     * {@see isItemActive}
     */
    public function withoutActivateItems(): self
    {
        $new = clone $this;
        $new->activateItems = false;
        return $new;
    }

    /**
     * @throws CircularReferenceException|InvalidConfigException|NotFoundException|NotInstantiableException
     */
    protected function run(): string
    {
        return $this->renderNav();
    }

    /**
     * Renders the given items as a dropdown.
     *
     * This method is called to create sub-menus.
     *
     * @param array $items the given items. Please refer to {@see Dropdown::items} for the array structure.
     *
     * @throws CircularReferenceException|InvalidConfigException|NotFoundException|NotInstantiableException
     *
     * @return string the rendering result.
     *
     * @link https://bulma.io/documentation/components/navbar/#dropdown-menu
     */
    private function renderDropdown(array $items): string
    {
        return Dropdown::widget()
            ->dividerCssClass('navbar-divider')
            ->/** @scrutinizer ignore-call */ dividerCssClass('navbar-divider')
            ->dropdownCssClass('navbar-dropdown')
            ->dropdownItemCssClass('navbar-item')
            ->items($items)
            ->enclosedByContainer()
            ->render() . PHP_EOL;
    }

    /**
     * Check to see if a child item is active optionally activating the parent.
     *
     * @param array $items {@see items}
     * @param bool $active Should the parent be active too.
     *
     * @return array
     *
     * {@see items}
     */
    private function isChildActive(array $items, bool &$active = false): array
    {
        /** @var array|string $child */
        foreach ($items as $i => $child) {
            /** @var string */
            $url = $child['url'] ?? '#';

            /** @var bool */
            $active = $child['active'] ?? false;

            if ($active === false && is_array($child)) {
                $items[$i]['active'] = $this->isItemActive($url, $this->currentPath, $this->activateItems);
            }

            if ($this->activateParents) {
                $active = true;
            }

            /** @var array */
            $childItems = $child['items'] ?? [];

            if ($childItems !== [] && is_array($items[$i])) {
                $items[$i]['items'] = $this->isChildActive($childItems);

                if ($active) {
                    $items[$i]['attributes'] = ['active' => true];
                    $active = true;
                }
            }
        }

        return $items;
    }

    /**
     * Checks whether a menu item is active.
     *
     * This is done by checking if {@see currentPath} match that specified in the `url` option of the menu item. When
     * the `url` option of a menu item is specified in terms of an array, its first element is treated as the
     * currentPath for the item and the rest of the elements are the associated parameters. Only when its currentPath
     * and parameters match {@see currentPath}, respectively, will a menu item be considered active.
     *
     * @param string $url The menu item's URL.
     * @param string $currentPath The currentPath.
     * @param bool $activateItems Whether to activate the parent menu items when the currentPath matches.
     *
     * @return bool whether the menu item is active
     */
    private function isItemActive(string $url, string $currentPath, bool $activateItems): bool
    {
        return ($currentPath !== '/') && ($url === $currentPath) && $activateItems;
    }

    private function renderLabelItem(
        string $label,
        string $iconText,
        string $iconCssClass,
        array $iconAttributes = []
    ): string {
        $html = '';

        if ($iconText !== '' || $iconCssClass !== '') {
            $html = Span::tag()
                ->attributes($iconAttributes)
                ->content(CustomTag::name('i')->class($iconCssClass)->content($iconText)->encode(false)->render())
                ->encode(false)
                ->render();
        }

        if ($label !== '') {
            $html .= $label;
        }

        return $html;
    }

    /**
     * Renders a widget's item.
     *
     * @param array $item the item to render.
     *
     * @throws CircularReferenceException|InvalidConfigException|NotFoundException|NotInstantiableException
     *
     * @return string the rendering result.
     */
    private function renderItem(array $item): string
    {
        $html = '';

        if (!isset($item['label'])) {
            throw new InvalidArgumentException('The "label" option is required.');
        }

        /** @var string */
        $itemLabel = $item['label'] ?? '';

        if (isset($item['encode']) && $item['encode'] === true) {
            $itemLabel = Html::encode($itemLabel);
        }

        /** @var array */
        $items = $item['items'] ?? [];

        /** @var string */
        $url = $item['url'] ?? '#';

        /** @var array */
        $urlAttributes = $item['urlAttributes'] ?? [];

        /** @var array */
        $dropdownAttributes = $item['dropdownAttributes'] ?? [];

        /** @var string */
        $iconText = $item['iconText'] ?? '';

        /** @var string */
        $iconCssClass = $item['iconCssClass'] ?? '';

        /** @var array */
        $iconAttributes = $item['iconAttributes'] ?? [];

        /** @var bool */
        $active = $item['active'] ?? $this->isItemActive($url, $this->currentPath, $this->activateItems);

        /** @var bool */
        $disabled = $item['disabled'] ?? false;

        $itemLabel = $this->renderLabelItem($itemLabel, $iconText, $iconCssClass, $iconAttributes);

        if ($disabled) {
            Html::addCssStyle($urlAttributes, 'opacity:.65; pointer-events:none;');
        }

        if ($this->activateItems && $active) {
            Html::addCssClass($urlAttributes, ['active' => 'is-active']);
        }

        if ($items !== []) {
            $attributes = $this->attributes;
            Html::addCssClass(
                $attributes,
                [$this->navBarItemCssClass, $this->hasDropdownCssClass, $this->isHoverableCssClass]
            );
            Html::addCssClass($urlAttributes, $this->navBarLinkCssClass);
            Html::addCssClass($dropdownAttributes, $this->navBarDropdownCssClass);

            $items = $this->isChildActive($items, $active);
            $dropdown = PHP_EOL . $this->renderDropdown($items);
            $a = A::tag()->attributes($urlAttributes)->content($itemLabel)->encode(false)->url($url)->render();
            $div = Div::tag()->attributes($dropdownAttributes)->content($dropdown)->encode(false)->render();
            $html = Div::tag()
                ->attributes($attributes)
                ->content(PHP_EOL . $a . PHP_EOL . $div . PHP_EOL)
                ->encode(false)
                ->render();
        }

        if ($html === '') {
            Html::addCssClass($urlAttributes, 'navbar-item');
            $html = A::tag()->attributes($urlAttributes)->content($itemLabel)->url($url)->encode(false)->render();
        }

        return $html;
    }

    /**
     * @throws CircularReferenceException|InvalidConfigException|NotFoundException|NotInstantiableException
     */
    private function renderNav(): string
    {
        $items = [];

        /** @var array|string $item */
        foreach ($this->items as $item) {
            $visible = !isset($item['visible']) || $item['visible'];

            if ($visible) {
                $items[] = is_string($item) ? $item : $this->renderItem($item);
            }
        }

        $links = PHP_EOL . implode("\n", $items) . PHP_EOL;

        if ($this->enclosedByStartMenu) {
            $links = PHP_EOL . Div::tag()->class($this->navBarStartCssClass)->content($links)->encode(false)->render() .
                PHP_EOL;
        }

        if ($this->enclosedByEndMenu) {
            $links = PHP_EOL . Div::tag()->class($this->navBarEndCssClass)->content($links)->encode(false)->render() .
                PHP_EOL;
        }

        return $this->items !== []
             ? Div::tag()
                ->class($this->navBarMenuCssClass)
                ->content($links)
                ->encode(false)
                ->render()
             : '';
    }
}

yiisoft / yii-bulma

Pull Request — master (#54)

Nav::items() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
