Tool.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
namespace ILIAS\GlobalScreen\Scope\Tool\Factory;
 
use Closure;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasContent;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasSymbol;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasTitle;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isTopItem;
use ILIAS\UI\Component\Component;
use ILIAS\UI\Component\Symbol\Glyph;
use ILIAS\UI\Component\Symbol\Icon;
use ILIAS\UI\Component\Symbol\Symbol;
use LogicException;
 
class Tool extends AbstractBaseTool implements isTopItem, hasContent, supportsTerminating
{
    protected $title;
    protected $terminated_callback;
    protected $symbol;
    protected $content;
    protected $content_wrapper;
    protected $close_callback;
 
    public function withTitle(string $title) : hasTitle
    {
        $clone = clone($this);
        $clone->title = $title;
 
        return $clone;
    }
 
    public function getTitle() : string
    {
        return $this->title;
    }
 
    public function withContentWrapper(Closure $content_wrapper) : hasContent
    {
        $clone = clone($this);
        $clone->content_wrapper = $content_wrapper;
 
        return $clone;
    }
 
    public function withContent(Component $ui_component) : hasContent
    {
        $clone = clone($this);
        $clone->content = $ui_component;
 
        return $clone;
    }
 
    public function getContent() : Component
    {
        if ($this->content_wrapper !== null) {
            $wrapper = $this->content_wrapper;
 
            return $wrapper();
        }
 
        return $this->content;
    }
 
    public function withSymbol(Symbol $symbol) : hasSymbol
    {
        // bugfix mantis 25526: make aria labels mandatory
        if (($symbol instanceof Glyph\Glyph && $symbol->getAriaLabel() === "") ||
            ($symbol instanceof Icon\Icon && $symbol->getLabel() === "")) {
            throw new LogicException("the symbol's aria label MUST be set to ensure accessibility");
        }
 
        $clone = clone($this);
        $clone->symbol = $symbol;
 
        return $clone;
    }
 
    public function getSymbol() : Symbol
    {
        return $this->symbol;
    }
 
    public function hasSymbol() : bool
    {
        return ($this->symbol instanceof Symbol);
    }
 
    public function withTerminatedCallback(Closure $callback) : supportsTerminating
    {
        $clone = clone $this;
        $clone->terminated_callback = $callback;
 
        return $clone;
    }
 
    public function getTerminatedCallback() : ?Closure
    {
        return $this->terminated_callback;
    }
 
    public function hasTerminatedCallback() : bool
    {
        return $this->terminated_callback instanceof Closure;
    }
}