Button.php

Go to the documentation of this file.

<?php

/* Copyright (c) 2016 Richard Klees <richard.klees@concepts-and-training.de> Extended GPL, see docs/LICENSE */

namespace ILIAS\UI\Implementation\Component\Button;

use ILIAS\UI\Component as C;
use ILIAS\UI\Component\Signal;
use ILIAS\UI\Implementation\Component\ComponentHelper;
use ILIAS\UI\Implementation\Component\JavaScriptBindable;
use ILIAS\UI\Implementation\Component\Triggerer;

abstract class Button implements C\Button\Button
{
    use ComponentHelper;
    use JavaScriptBindable;
    use Triggerer;

    protected $label;

    protected $action;

    protected $active = true;

    protected $aria_label;

    protected $aria_checked = false;


    public function __construct($label, $action)
    {
        $this->checkStringArg("label", $label);
        $this->checkStringOrSignalArg("action", $action);
        $this->label = $label;
        if (is_string($action)) {
            $this->action = $action;
        } else {
            $this->action = null;
            $this->setTriggeredSignal($action, "click");
        }
    }

    public function getLabel()
    {
        return $this->label;
    }

    public function withLabel($label)
    {
        $this->checkStringArg("label", $label);
        $clone = clone $this;
        $clone->label = $label;
        return $clone;
    }

    public function getAction()
    {
        if ($this->action !== null) {
            return $this->action;
        }
        return $this->getTriggeredSignalsFor("click");
    }

    public function isActive()
    {
        return $this->active;
    }

    public function withUnavailableAction()
    {
        $clone = clone $this;
        $clone->active = false;
        return $clone;
    }

    public function withOnClick(Signal $signal)
    {
        $this->action = null;
        return $this->withTriggeredSignal($signal, 'click');
    }

    public function appendOnClick(Signal $signal)
    {
        return $this->appendTriggeredSignal($signal, 'click');
    }

    public function withOnHover(Signal $signal)
    {
        // Note: The event 'hover' maps to 'mouseenter' in javascript. Although 'hover' is available in JQuery,
        // it encodes the 'mouseenter' and 'mouseleave' events and thus expects two event handlers.
        // In the context of this framework, the signal MUST only be triggered on the 'mouseenter' event.
        // See also: https://api.jquery.com/hover/
        return $this->withTriggeredSignal($signal, 'mouseenter');
    }

    public function appendOnHover(Signal $signal)
    {
        return $this->appendTriggeredSignal($signal, 'mouseenter');
    }

    public function withAriaLabel($aria_label)
    {
        $this->checkStringArg("label", $aria_label);
        $clone = clone $this;
        $clone->aria_label = $aria_label;
        return $clone;
    }

    public function getAriaLabel()
    {
        return $this->aria_label;
    }

    public function withAriaChecked()
    {
        $clone = clone $this;
        $clone->aria_checked = true;
        return $clone;
    }

    public function isAriaChecked()
    {
        return $this->aria_checked;
    }
}