Grido\Components\Actions\Action

Complexity

Total Complexity

26

Size/Duplication

Total Lines	219
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	3

Test Coverage

Coverage

91.53%

Importance

Changes	5
Bugs	0	Features	0

14 Methods

Rating	Name	Duplication	Size	Complexity
A	getElement()	0	16	4
A	__construct()	0	7	1
A	setElementPrototype()	0	5	1
A	setCustomRender()	0	5	1
A	setPrimaryKey()	0	5	1
A	setDisable()	0	5	1
A	setConfirm()	0	5	1
A	getElementPrototype()	0	14	3
A	getPrimaryKey()	0	8	2
A	getOption()	0	6	2
B	render()	0	15	5
A	setIcon()	0	5	1
A	getOptions()	0	4	1
A	setOption()	0	11	2

<?php

/**
 * This file is part of the Grido (http://grido.bugyik.cz)
 *
 * Copyright (c) 2011 Petr Bugyík (http://petr.bugyik.cz)
 *
 * For the full copyright and license information, please view
 * the file LICENSE.md that was distributed with this source code.
 */

namespace Grido\Components\Actions;

use Grido\Exception;
use Nette\Utils\Html;

/**
 * Action on one row.
 *
 * @package     Grido
 * @subpackage  Components\Actions
 * @author      Petr Bugyík
 *
 * @property-read Html $element
 * @property-write callback $customRender
 * @property-write callback $disable
 * @property Html $elementPrototype
 * @property string $primaryKey
 * @property string $options
 */
abstract class Action extends \Grido\Components\Component
{
    const ID = 'actions';

    /** @var Html <a> html tag */
    protected $elementPrototype;

    /** @var callback for custom rendering */
    protected $customRender;

    /** @var string - name of primary key f.e.: link->('Article:edit', array($primaryKey => 1)) */
    protected $primaryKey;

    /** @var callback for disabling */
    protected $disable;

    /** @var string */
    protected $options;

    /**
     * @param \Grido\Grid $grid
     * @param string $name
     * @param string $label
     */
    public function __construct($grid, $name, $label)
    {
        $this->addComponentToGrid($grid, $name);

        $this->type = get_class($this);
        $this->label = $this->translate($label);
    }

    /**
     * Sets html element.
     * @param Html $elementPrototype
     * @return Action
     */
    public function setElementPrototype(Html $elementPrototype)
    {
        $this->elementPrototype = $elementPrototype;
        return $this;
    }

    /**
     * Sets callback for custom rendering.
     * @param callback
     * @return Action
     */
    public function setCustomRender($callback)
    {
        $this->customRender = $callback;
        return $this;
    }

    /**
     * Sets primary key.
     * @param string $primaryKey
     * @return Action
     */
    public function setPrimaryKey($primaryKey)
    {
        $this->primaryKey = $primaryKey;
        return $this;
    }

    /**
     * Sets callback for disable.
     * Callback should return TRUE if the action is not allowed for current item.
     * @param callback
     * @return Action
     */
    public function setDisable($callback)
    {
        $this->disable = $callback;
        return $this;
    }

    /**
     * Sets client side confirm.
     * @param string|callback $confirm
     * @return Action
     */
    public function setConfirm($confirm)
    {
        $this->setOption('confirm', $confirm);
        return $this;
    }

    /**
     * Sets name of icon.
     * @param string $name
     * @return Action
     */
    public function setIcon($name)
    {
        $this->setOption('icon', $name);
        return $this;
    }

    /**
     * Sets user-specific option.
     * @param string $key
     * @param mixed $value
     * @return Action
     */
    public function setOption($key, $value)
    {
        if ($value === NULL) {
            unset($this->options[$key]);

        } else {
            $this->options[$key] = $value;
        }

        return $this;
    }

    /**********************************************************************************************/

    /**
     * Returns element prototype (<a> html tag).
     * @return Html
     * @throws Exception
     */
    public function getElementPrototype()
    {
        if ($this->elementPrototype === NULL) {
            $this->elementPrototype = Html::el('a')
                ->setClass(['grid-action-' . $this->getName()])
                ->setText($this->label);
        }

        if (isset($this->elementPrototype->class)) {
            $this->elementPrototype->class = (array) $this->elementPrototype->class;
        }

        return $this->elementPrototype;
    }

    /**
     * @return string
     * @internal
     */
    public function getPrimaryKey()
    {
        if ($this->primaryKey === NULL) {
            $this->primaryKey = $this->grid->getPrimaryKey();
        }

        return $this->primaryKey;
    }

    /**
     * @param mixed $row
     * @return Html
     * @internal
     */
    public function getElement($row)
    {
        $element = clone $this->getElementPrototype();

        if ($confirm = $this->getOption('confirm')) {
            $confirm = is_callable($confirm)
                ? call_user_func_array($confirm, [$row])
                : $confirm;

            $element->data['grido-confirm'] = is_array($confirm)
                ? vsprintf($this->translate(array_shift($confirm)), $confirm)
                : $this->translate($confirm);
        }

        return $element;
    }

    /**
     * Returns user-specific option.
     * @param string $key
     * @param mixed $default
     * @return mixed
     */
    public function getOption($key, $default = NULL)
    {
        return isset($this->options[$key])
            ? $this->options[$key]
            : $default;
    }

    /**
     * Returns user-specific options.
     * @return array
     */
    public function getOptions()
    {
        return $this->options;
    }

    /**********************************************************************************************/

    /**
     * @param mixed $row
     * @throws Exception
     * @return void
     */
    public function render($row)
    {
        if (!$row || ($this->disable && call_user_func_array($this->disable, [$row]))) {
            return;
        }

        $element = $this->getElement($row);

        if ($this->customRender) {
            echo call_user_func_array($this->customRender, [$row, $element]);
            return;
        }

        echo $element->render();
    }
}