LinkList.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item;
 
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\AbstractChildItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasSymbol;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasSymbolTrait;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasTitle;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isChild;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isInterchangeableItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isInterchangeableItemTrait;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\supportsAsynchronousLoading;
use ILIAS\GlobalScreen\Scope\SymbolDecoratorTrait;
use InvalidArgumentException;
use ReflectionFunction;
use ReflectionException;
use Generator;
 
class LinkList extends AbstractChildItem implements
    hasTitle,
    supportsAsynchronousLoading,
    hasSymbol,
    isInterchangeableItem,
    isChild
{
    use SymbolDecoratorTrait;
    use hasSymbolTrait;
    use isInterchangeableItemTrait;
 
    protected string $title = '';
    protected array $links = [];
    protected bool $supports_async_loading = false;
 
    public function withTitle(string $title): hasTitle
    {
        $clone = clone($this);
        $clone->title = $title;
 
        return $clone;
    }
 
    public function getTitle(): string
    {
        return $this->title;
    }
 
    public function withLinks($links): self
    {
        if (is_callable($links)) {
            try {
                $r = new ReflectionFunction($links);
                $links = $r->isGenerator() ? iterator_to_array($links()) : $links();
            } catch (ReflectionException $e) {
                $links = false;
            }
 
            if (!is_array($links)) {
                throw new InvalidArgumentException("withLinks only accepts arrays of Links or a callable providing them");
            }
        }
        foreach ($links as $link) {
            if (!$link instanceof Link) {
                throw new InvalidArgumentException("withLinks only accepts arrays of Links or a callable providing them");
            }
        }
        $clone = clone($this);
        $clone->links = $links;
 
        return $clone;
    }
 
    public function getLinks(): array
    {
        return $this->links;
    }
 
    public function withSupportsAsynchronousLoading(bool $supported): supportsAsynchronousLoading
    {
        $clone = clone($this);
        $clone->supports_async_loading = $supported;
 
        return $clone;
    }
 
    public function supportsAsynchronousLoading(): bool
    {
        return $this->supports_async_loading;
    }
 
    public function isVisible(): bool
    {
        $visible_links = 0;
        foreach ($this->getLinks() as $link) {
            if ($link->isVisible()) {
                $visible_links++;
            }
        }
        return $visible_links > 0 && parent::isVisible();
    }
}