StandardToastItem.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\GlobalScreen\Scope\Toast\Factory;
 
use ILIAS\GlobalScreen\Identification\IdentificationInterface;
use ILIAS\UI\Component\Symbol\Icon\Icon;
use ILIAS\GlobalScreen\Scope\Toast\Collector\Renderer\ToastRenderer;
 
class StandardToastItem implements isStandardItem
{
    private const ACTION_SHOWN = 'shown';
    private const ACTION_CLOSED = 'closed';
    private const ACTION_VANISHED = 'vanished';
    protected ?string $description = null;
    protected array $additional_actions = [];
 
    protected ?ToastAction $handle_shown = null;
 
    protected ?ToastAction $handle_closed = null;
    private ?ToastAction $handle_vanished = null;
 
    public function __construct(protected IdentificationInterface $provider_identification, protected ToastRenderer $renderer, protected string $title, protected ?Icon $icon = null)
    {
    }
 
    private function packClosure(?\Closure $closure, string $identifier, string $title): ?ToastAction
    {
        if ($closure === null) {
            return null;
        }
        return new ToastAction(
            $identifier,
            $title,
            $closure
        );
    }
 
    public function getTitle(): string
    {
        return $this->title;
    }
 
    public function withDescription(string $description): isStandardItem
    {
        $clone = clone $this;
        $clone->description = $description;
        return $clone;
    }
 
    public function getDescription(): ?string
    {
        return $this->description;
    }
 
    final public function withAdditionToastAction(ToastAction $action): isStandardItem
    {
        if (in_array(
            $action->getIdentifier(),
            [self::ACTION_SHOWN, self::ACTION_CLOSED, self::ACTION_VANISHED],
            true
        )) {
            throw new \InvalidArgumentException(
                'You cannot use the reserved identifiers shown, closed or vanished for additional actions'
            );
        }
 
        $existing = array_map(fn(ToastAction $action): string => $action->getIdentifier(), $this->additional_actions);
 
        if (in_array($action->getIdentifier(), $existing, true)) {
            throw new \InvalidArgumentException(
                'You cannot use the same identifier twice'
            );
        }
 
        $clone = clone $this;
        $clone->additional_actions[] = $action;
        return $clone;
    }
 
    final public function getAllToastActions(): array
    {
        $actions = $this->additional_actions;
        $actions[] = $this->handle_shown;
        $actions[] = $this->handle_closed;
        $actions[] = $this->handle_vanished;
 
        $actions = array_filter($actions, fn(?ToastAction $action): bool => $action !== null);
 
        return $actions;
    }
 
    final public function getAdditionalToastActions(): array
    {
        return $this->additional_actions;
    }
 
    public function withIcon(Icon $icon): isStandardItem
    {
        $clone = clone $this;
        $clone->icon = $icon;
        return $clone;
    }
 
    public function getIcon(): ?Icon
    {
        return $this->icon;
    }
 
    public function getProviderIdentification(): IdentificationInterface
    {
        return $this->provider_identification;
    }
 
    final public function withShownCallable(\Closure $handle_shown): isStandardItem
    {
        $clone = clone $this;
        $clone->handle_shown = $this->packClosure(
            $handle_shown,
            self::ACTION_SHOWN,
            self::ACTION_SHOWN
        );
 
        return $clone;
    }
 
    final public function getShownAction(): ToastAction
    {
        return $this->handle_shown;
    }
 
    final public function hasShownAction(): bool
    {
        return $this->handle_shown !== null;
    }
 
    final public function withClosedCallable(\Closure $handle_closed): isStandardItem
    {
        $clone = clone $this;
        $clone->handle_closed = $this->packClosure(
            $handle_closed,
            self::ACTION_CLOSED,
            self::ACTION_CLOSED
        );
 
        return $clone;
    }
 
    final public function getClosedAction(): ?ToastAction
    {
        return $this->handle_closed;
    }
 
    final public function hasClosedAction(): bool
    {
        return $this->handle_closed !== null;
    }
 
    public function withVanishedCallable(\Closure $handle_vanished): isStandardItem
    {
        $clone = clone $this;
        $clone->handle_vanished = $this->packClosure(
            $handle_vanished,
            self::ACTION_VANISHED,
            self::ACTION_VANISHED
        );
 
        return $clone;
    }
 
    public function getVanishedAction(): ?ToastAction
    {
        return $this->handle_vanished;
    }
 
    public function hasVanishedAction(): bool
    {
        return $this->handle_vanished !== null;
    }
 
    final public function getRenderer(): ToastRenderer
    {
        return $this->renderer;
    }
}